Class: naver.maps.KVOArray

Extends

• naver.maps.KVO

Methods

addListener(eventName, listener)

현재 객체의 이벤트 알림을 받아 핸들러를 호출하는 리스너를 등록합니다.

이 메서드는 Event의 addListener 메서드를 상속받습니다.

Parameters

Name	Type	Description
eventName	string	이벤트 이름
listener	function	이벤트 리스너

Inherited From

• naver.maps.KVO#addListener

Returns

Type	Description
MapEventListener	지도 이벤트 리스너 객체

addListenerOnce(eventName, listener)

현재 객체에서 한 번만 이벤트 알림을 받아 핸들러를 호출하는 리스너를 등록합니다.

이 메서드는 Event의 once 메서드를 상속받습니다.

Parameters

Name	Type	Description
eventName	string	이벤트 이름
listener	function	이벤트 리스너

Inherited From

• naver.maps.KVO#addListenerOnce

Returns

Type	Description
MapEventListener	지도 이벤트 리스너 객체

bindTo(key, target, targetKey)

대상 객체(target)의 대상 키(targetKey)에 자신의 키(key)를 바인딩합니다. 따라서 대상 객체의 대상 키의 값이 변경되면 자신의 키의 값 역시 갱신됩니다.

즉, 대상 객체에서 사용하는 대상 키에 바인딩하면서 자신만의 키 이름을 설정할 때 사용할 수 있습니다. 대상 키가 없으면 동일한 키 이름을 사용합니다.

Parameters

Name	Type	Argument	Description
key	string		키
target	naver.maps.KVO		대상 객체
targetKey	string	<optional>	대상 객체에 존재하는 키

Inherited From

• naver.maps.KVO#bindTo

Fires

• {key}_changed

clear()

모든 요소를 삭제합니다.

이 메서드는 remove_at 이벤트를 발생시킵니다.

clearListeners(eventName)

현재 객체에서 특정 이벤트 알림의 리스너를 모두 제거합니다.

이 메서드는 Event의 clearListeners 메서드를 상속받습니다.

Parameters

Name	Type	Description
eventName	string	모두 제거할 이벤트의 이름

Inherited From

• naver.maps.KVO#clearListeners

forEach(callback)

배열의 전체 요소를 순회하며 콜백 함수를 실행합니다.

Parameters

Name	Type	Description
callback	function	순회 시 실행할 콜백 함수 Properties Name Type Description element any 요소 index number 요소의 인덱스

get(key)

키에 해당하는 값을 반환합니다.

Parameters

Name	Type	Description
key	string	키

Inherited From

• naver.maps.KVO#get

Returns

Type	Description
any	키에 할당되어 있는 값

getArray()

원본 배열 객체를 반환합니다.

Returns

Type	Description
array	원본 배열

getAt(index)

특정 인덱스의 요소를 반환합니다.

Parameters

Name	Type	Description
index	number	인덱스

Returns

Type	Description
any	해당 인덱스의 요소

getIndexOfElement(element)

특정 요소의 인덱스를 반환합니다.

Parameters

Name	Type	Description
element	any	인덱스를 검색할 요소

Returns

Type	Description
number	해당 요소의 인덱스

getLength()

배열의 전체 길이를 반환합니다.

Returns

Type	Description
number	배열의 전체 길이

hasListener(eventName)

현재 객체에 이벤트 알림이 등록되었는지 여부를 확인합니다.

이 메서드는 Event의 hasListener 메서드를 상속받습니다.

Parameters

Name	Type	Description
eventName	string	이벤트 이름

Inherited From

• naver.maps.KVO#hasListener

Returns

Type	Description
boolean	등록 여부

insertAt(index, element)

특정 인덱스에 요소를 삽입합니다.

이 메서드는 insert_at 이벤트를 발생시킵니다.

Parameters

Name	Type	Description
index	number	배열의 인덱스. 이 값이 음수이면 "index number should be positive" 오류가 발생합니다.
element	any	삽입할 요소의 값

pop()

배열의 마지막 요소를 삭제하고, 삭제된 요소를 반환합니다.

이 메서드는 remove_at 이벤트를 발생시킵니다.

이 메서드는 JavaScript 배열의 pop 메서드를 구현합니다.

Returns

Type	Description
any	삭제된 요소

push(element)

배열의 마지막에 요소를 추가합니다.

이 메서드는 insert_at 이벤트를 발생시킵니다.

이 메서드는 JavaScript 배열의 push 메서드를 구현합니다.

Parameters

Name	Type	Description
element	any	추가할 요소

Returns

Type	Description
number	배열의 전체 길이

removeAt(index)

특정 인덱스의 요소를 삭제하고, 삭제된 요소를 반환합니다.

이 메서드는 remove_at 이벤트를 발생시킵니다.

Parameters

Name	Type	Description
index	number	배열의 인덱스. 이 값이 음수이면, "index number should be positive" 오류가 발생합니다.

Returns

Type	Description
any	삭제된 요소의 값

removeElement(element)

특정 요소를 삭제합니다.

Parameters

Name	Type	Description
element	any	삭제할 요소

removeListener(listeners)

특정 이벤트 알림의 리스너를 제거합니다.

이 메서드는 Event의 removeListener 메서드를 상속받습니다.

Parameters

Name	Type	Description
listeners	MapEventListener | Array.<MapEventListener>	제거할 리스너 객체 또는 리스너 객체의 배열

Inherited From

• naver.maps.KVO#removeListener

set(key, value, silently)

키(key)에 해당하는 값을 객체에 설정합니다.

값이 설정되면 해당 객체의 키를 바인딩하고 있는 모든 KVO 객체에 동일한 값이 적용됩니다.
또한, {key}_changed 형태의 이벤트를 이용해 값의 변경을 감지할 수 있습니다.

Parameters

Name	Type	Argument	Description
key	string		키
value	any		키에 저장할 값
silently	boolean	<optional>	묵시적으로 값을 설정할지 여부. 이 값이 true이면 이벤트를 발생시키지 않습니다.

Inherited From

• naver.maps.KVO#set

Fires

• {key}_changed

setAt(index, element)

특정 인덱스에 요소를 설정합니다.

Parameters

Name	Type	Description
index	number	배열의 인덱스. 이 값이 현재 배열 length-1보다 크면 insertAt을 호출합니다.
element	any	설정할 요소의 값

Fires

• set_at
• insert_at

setValues(properties)

키-값 쌍 형태로 동시에 여러 개의 값을 설정합니다.

Parameters

Name	Type	Description
properties	object	설정할 키-값 쌍의 객체

Inherited From

• naver.maps.KVO#setValues

Fires

• {key}_changed

splice(startIndex, deleteCount, element)

startIndex로부터 deleteCount만큼의 요소를 삭제하고, 신규 요소를 삽입합니다.

삭제한 요소가 존재한다면 삭제된 요소들의 배열을 반환합니다.

이 메서드는 JavaScript 배열의 splice 메서드를 구현합니다.

Parameters

Name	Type	Argument	Default	Description
startIndex	number			시작 인덱스
deleteCount	number		0	시작 인덱스로부터 삭제할 요소의 개수
element	any	<optional> <repeatable>		시작 인덱스에 삽입할 새로운 요소

Returns

Type	Description
Array.<any>	삭제된 요소의 배열

trigger(eventName, eventObject)

현재 객체에 이벤트 알림을 발생시킵니다.

이 메서드는 Event의 trigger 메서드를 상속받습니다.

Parameters

Name	Type	Argument	Description
eventName	string		이벤트 이름
eventObject	any	<optional> <repeatable>	이벤트 리스너에 전달할 이벤트 객체

Inherited From

• naver.maps.KVO#trigger

unbind(key)

해당 키의 바인딩을 제거합니다.

Parameters

Name	Type	Description
key	string	제거할 키

Inherited From

• naver.maps.KVO#unbind

unbindAll()

모든 바인딩을 제거합니다.

Inherited From

• naver.maps.KVO#unbindAll

Events

insert_at

새로운 요소가 추가되면 이벤트가 발생합니다. 추가된 요소의 인덱스와 요소가 인수로 전달됩니다.

Parameters

Name	Type	Description
index	number	삽입된 요소의 인덱스
element	any	삽입된 요소

remove_at

기존의 요소가 삭제되면 이벤트가 발생합니다. 삭제된 요소와 인덱스가 인수로 전달됩니다.

Parameters

Name	Type	Description
index	number	삭제된 요소의 인덱스
element	any	삭제된 요소

set_at

기존의 요소가 변경되면 이벤트가 발생합니다. 기존 요소(변경되어 삭제된)와 변경된 인덱스가 인수로 전달됩니다.

Parameters

Name	Type	Description
index	number	인덱스
element	any	삭제된 요소

{key}_changed

특정 key의 값이 변경되면 {key}_changed 이벤트가 발생합니다.

Parameters

Name	Type	Description
value	any	해당 키의 변경된 값

Inherited From

• naver.maps.KVO#event:{key}_changed