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

Class: naver.maps.ImageTile

naver.maps. ImageTile

ImageTile 클래스는 한 장의 이미지 타일을 정의합니다.

new naver.maps.ImageTile(imageTileOptions)

Parameters
Name Type Argument Description
imageTileOptions ImageTileOptions <optional>

이미지 타일의 옵션

Extends

Methods

appendTo(parentNode)

지정한 parentNode에 타일 HTML 요소를 추가합니다.

Parameters
Name Type Description
parentNode HTMLElement

타일이 추가될 HTML 요소

Inherited From

cancelFadeIn()

진행 중인 페이드 인(타일이 서서히 나타나는) 효과를 즉시 중지하고, 본래의 불투명도를 설정합니다.

Inherited From

destroy()

이미지 타일 객체를 완전히 삭제합니다.

Overrides

fadeIn(callback, startOpacity)

페이드 인(타일이 서서히 나타나는) 효과를 실행합니다.

Parameters
Name Type Argument Default Description
callback function

페이드 인 효과가 완료되었을 때 실행할 콜백 함수입니다.

startOpacity number <optional>
0

페이드 인 효과의 시작 불투명도입니다.

Inherited From

getDuration()

타일의 fadeIn 효과 지속시간을 반환합니다.

Inherited From
Returns
Type Description
number

타일의 fadeIn animation duration

getElement()

타일의 HTML 요소를 반환합니다.

Inherited From
Returns
Type Description
HTMLElement

타일의 HTML 요소

getImageElements()

타일의 모든 HTML 이미지 요소의 배열을 반환합니다.

Returns
Type Description
Array.<HTMLElement>

HTML 이미지 요소의 배열

getOffset()

타일의 오프셋(위치)을 반환합니다.

Inherited From
Returns
Type Description
naver.maps.Point

타일의 오프셋

getOpacity()

타일의 불투명도를 반환합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Inherited From
Returns
Type Description
number

0~1 사이의 실수.

getSize()

타일의 크기를 반환합니다.

Inherited From
Returns
Type Description
naver.maps.Size

타일의 크기

getTileIndex()

타일 인덱스를 반환합니다.

Inherited From
Returns
Type Description
TileIndex

타일 인덱스

getUrls()

타일에 포함된 이미지 URL의 목록을 반환합니다.

Returns
Type Description
Array.<string>

이미지 URL의 배열

getZIndex()

타일의 쌓임 순서를 반환합니다.

Inherited From
Returns
Type Description
number

타일의 쌓임 순서

hide()

타일을 숨깁니다.

Inherited From

load(imageTileOptions)

이미지 타일을 불러옵니다.

Parameters
Name Type Argument Description
imageTileOptions ImageTileOptions <optional>

이미지 타일의 옵션

Overrides

remove()

이미지 타일의 HTML 요소를 지도상에서 삭제합니다.

Overrides

reset(mapType, zoom, imageTileOptions)

지정한 mapType에 맞게 타일을 재설정합니다.

Parameters
Name Type Argument Description
mapType naver.maps.ImageMapType

재설정할 이미지 지도 유형

zoom number

타일 재설정 시 적용할 지도의 줌 레벨

imageTileOptions ImageTileOptions <optional>

이미지 타일의 옵션

Overrides

setBlank()

이미지 타일을 투명한 공백 타일로 설정합니다.

Overrides

setDuration(duration)

타일의 fadeIn 효과 지속시간을 설정합니다.
단위는 밀리초 (millisecond), 기본값은 300~600ms 입니다.

Parameters
Name Type Description
duration number

타일의 fadeIn animation duration

Inherited From

setOffset(offset)

타일이 표시될 오프셋(위치)을 지정합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

Inherited From
Overrides

setOpacity(opacity)

타일의 불투명도를 지정합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Parameters
Name Type Description
opacity number

불투명도 0~1 사이의 실수.

Inherited From

setSize(size)

타일의 크기를 설정합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

Inherited From

setTileIndex(tileIndex)

타일 인덱스를 설정합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일 인덱스

Inherited From

setUrls(urls)

타일에 포함될 이미지 URL의 목록을 설정합니다.

Parameters
Name Type Description
urls Array.<string>

이미지 URL의 배열

setZIndex(zIndex)

타일의 쌓임 순서를 설정합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서

Inherited From

show()

타일을 보이게 합니다.

Inherited From

Type Definitions


ImageTileOptions

ImageTileOptions 객체는 naver.maps.ImageTile을 정의하는 데 필요한 옵션을 나타냅니다.

Type:
Properties
Name Type Argument Default Description
urls Array.<string>

한 장의 타일에 포함될 이미지 URL의 목록입니다.

imgonload function <optional>

각 이미지가 로드되면 호출할 이벤트 핸들러입니다.

imgonerror function <optional>

각 이미지의 로드가 실패하면 호출할 이벤트 핸들러입니다.

opacity number <optional>
1

타일의 불투명도

transition boolean <optional>
true

타일 로드 시 fadeIn 효과의 사용 여부입니다.

duration number <optional>

타일의 fadeIn 효과 지속 시간입니다. (밀리초 단위)

offset naver.maps.Point <optional>

타일의 오프셋입니다.

zIndex number <optional>
0

타일의 쌓임 순서입니다.

size naver.maps.Size <optional>

타일의 크기입니다.

pane HTMLElement <optional>

타일이 추가될 HTML 요소입니다.

Events

loaded

타일의 로드가 완료되면 이벤트가 발생합니다.

Parameters
Name Type Description
tile naver.maps.Tile

로드가 완료된 타일 객체

Inherited From

offset_changed

타일의 오프셋(위치)이 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

Inherited From

opacity_changed

타일의 불투명도가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
opacity number

타일의 불투명도

Inherited From

pane_changed

타일이 추가된 HTML 요소가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
paneElement HTMLElement

타일이 추가된 HTML 요소

Inherited From

size_changed

타일의 크기가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

Inherited From

tileIndex_changed

타일의 인덱스가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일의 인덱스

Inherited From

urls_changed

타일에 포함된 이미지 URL의 목록이 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
urls Array.<string>

타일에 포함된 이미지 URL의 배열

zIndex_changed

타일의 쌓임 순서가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서

Inherited From