new naver.maps.InfoWindow(options)
Parameters
Name | Type | Description |
---|---|---|
options |
InfoWindowOptions | 정보 창 옵션. |
- Tutorials
Extends
Methods
-
close()
-
정보 창을 닫습니다.
-
getContent()
-
정보 창 내부의 콘텐츠를 반환합니다.
Returns
Type Description string | HTMLElement
정보 창 콘텐츠
-
getContentElement()
-
정보 창 내부의 콘텐츠를 DOM 노드로 반환합니다.
Returns
Type Description HTMLElement
정보 창 콘텐츠
-
getOptions(key)
-
정보 창 옵션을 반환합니다.
Parameters
Name Type Argument Description key
string <optional>
반환받을 옵션 이름
Returns
Type Description InfoWindowOptions
정보 창 옵션
-
getPosition()
-
정보 창의 위치를 반환합니다.
Returns
Type Description Coord
정보 창 위치
-
getZIndex()
-
정보 창의 쌓임 순서를 반환합니다.
Returns
Type Description number
정보 창의 쌓임 순서
-
open(map, anchor)
-
정보 창을 엽니다. 앵커를 전달하면 앵커 위에 정보 창을 엽니다.
Parameters
Name Type Argument Description map
naver.maps.Map Map 객체
anchor
Coord | CoordLiteral | naver.maps.Marker <optional>
정보 창이 표시될 위치. 직접 좌표를 정의하거나 naver.maps.Marker 인스턴스를 참조하도록 할 수 있습니다.
단, 마커를 참조하는 경우 마커 아이콘의size
와anchor
옵션이 마커 생성 시에 정의되어야 올바른 위치로 표현됩니다. -
setContent(content)
-
정보 창 내부에 표시할 콘텐츠(텍스트 또는 DOM 노드 문자열)를 설정합니다.
Parameters
Name Type Description content
string | HTMLElement 정보 창 콘텐츠
Fires
-
setOptions(options)
-
정보 창 옵션을 설정합니다. 설정한 옵션만 반영됩니다.
Parameters
Name Type Description options
InfoWindowOptions 정보 창 옵션
Fires
-
setPosition(position)
-
정보 창의 위치를 설정합니다.
Parameters
Name Type Description position
Coord | CoordLiteral 정보 창 위치
Fires
-
setZIndex(zIndex)
-
정보 창의 쌓임 순서를 설정합니다.
Parameters
Name Type Description zIndex
number 정보 창의 쌓임 순서
Fires
Type Definitions
-
InfoWindowOptions
-
InfoWindowOptions
객체는InfoWindow
를 정의하는 옵션을 나타냅니다.Type:
Properties
Name Type Argument Default Description position
Coord | CoordLiteral 정보 창의 위치입니다.
content
string | HTMLElement 정보 창의 콘텐츠입니다.
zIndex
number <optional>
0 정보 창의 쌓임 순서입니다.
maxWidth
number <optional>
0 정보 창의 최대 너비입니다. 단위는 픽셀(px)입니다. 기본값은
0
으로 최대 너비를 제한하지 않습니다.pixelOffset
naver.maps.Point | PointLiteral <optional>
정보 창의 꼬리에서 정보 창이 위치한 지점까지의 오프셋입니다.
backgroundColor
string <optional>
#fff 정보 창의 배경색입니다. CSS 색상 표현법으로 설정합니다.
borderColor
string <optional>
#333 정보 창의 테두리 색상입니다. CSS 색상 표현법으로 설정합니다.
borderWidth
number <optional>
1 정보 창의 테두리 두께입니다.
disableAutoPan
boolean <optional>
false 정보 창을 열 때 정보 창 전체를 보여줄 수 있는 자동 이동(패닝) 사용 여부입니다.
disableAnchor
boolean <optional>
false 기본 말풍선 꼬리의 사용 여부입니다.
anchorSkew
boolean <optional>
false 기본 말풍선 꼬리의 기울임(skew) 효과 사용 여부입니다.
anchorSize
naver.maps.Size | SizeLiteral <optional>
(width: 20, height: 24) 기본 말풍선 꼬리의 크기입니다.
anchorColor
string <optional>
#fff 기본 말풍선 꼬리의 색상입니다. CSS 색상 표현법으로 설정합니다.
autoPanPadding
naver.maps.Point 자동 이동(패닝) 사용 시 적용되는 여백(패딩)입니다. 단위는 화면 픽셀이며, 기본값은
{x: 20, y: 20}
입니다.
Events
-
anchorColor_changed
-
Parameters
Name Type Description anchorColor
string 정보 창 말풍선 꼬리의 색상 옵션이 변경되면 이벤트가 발생합니다.
-
anchorSize_changed
-
Parameters
Name Type Description anchorSize
naver.maps.Size 정보 창 말풍선 꼬리 크기 옵션이 변경되면 이벤트가 발생합니다.
-
anchorSkew_changed
-
Parameters
Name Type Description anchorSkew
boolean 정보 창 말풍선 꼬리의 기울임(skew) 효과 사용 여부 옵션이 변경되면 이벤트가 발생합니다.
-
backgroundColor_changed
-
Parameters
Name Type Description backgroundColor
string 정보 창의 배경색 옵션이 변경되면 이벤트가 발생합니다.
-
borderColor_changed
-
Parameters
Name Type Description borderColor
string 정보 창의 테두리 색상 옵션이 변경되면 이벤트가 발생합니다.
-
borderWidth_changed
-
Parameters
Name Type Description borderWidth
number 정보 창의 테두리 너비 옵션이 변경되면 이벤트가 발생합니다.
-
close
-
정보 창이 닫히면 이벤트가 발생합니다.
Parameters
Name Type Description pointerEvent
PointerEvent 포인터 이벤트 객체
-
content_changed
-
Parameters
Name Type Description content
HTMLElement 정보 창의 콘텐츠 옵션이 변경되면 이벤트가 발생합니다.
-
disableAnchor_changed
-
Parameters
Name Type Description disableAnchor
boolean 정보 창의 말풍선 꼬리의 사용 여부 옵션이 변경되면 이벤트가 발생합니다.
-
disableAutoPan_changed
-
Parameters
Name Type Description disableAutoPan
boolean 정보 창을 열 때 정보 창 전체를 보여줄 수 있는 자동 이동(패닝) 사용 여부 옵션이 변경되면 이벤트가 발생합니다.
-
maxWidth_changed
-
Parameters
Name Type Description maxWidth
number 정보 창의 최대 너비 옵션이 변경되면 이벤트가 발생합니다.
-
open
-
정보 창이 열리면 이벤트가 발생합니다.
Parameters
Name Type Description pointerEvent
PointerEvent 포인터 이벤트 객체
-
pixelOffset_changed
-
Parameters
Name Type Description pixelOffset
naver.maps.Point 정보 창의 말풍선 꼬리에서 정보 창이 위치한 지점까지의 오프셋 옵션이 변경되면 이벤트가 발생합니다.
-
position_changed
-
Parameters
Name Type Description position
Coord 정보 창의 위치 옵션이 변경되면 이벤트가 발생합니다.
-
zIndex_changed
-
Parameters
Name Type Description zIndex
number 정보 창의 쌓임 순서 옵션이 변경되면 이벤트가 발생합니다.