logo
Tutorials Examples naver map js api v3 네이버 지도 API InfoWindow

Class: naver.maps.InfoWindow

naver.maps. InfoWindow

InfoWindow 클래스는 지도 위에 올리는 정보 창을 정의합니다.

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 인스턴스를 참조하도록 할 수 있습니다.
단, 마커를 참조하는 경우 마커 아이콘의 sizeanchor 옵션이 마커 생성 시에 정의되어야 올바른 위치로 표현됩니다.

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

정보 창의 쌓임 순서 옵션이 변경되면 이벤트가 발생합니다.