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

Class: naver.maps.KVOArray

naver.maps. KVOArray

KVOArray 클래스는 배열 형태의 KVO를 정의합니다. 따라서 배열 요소의 값이 변경되면 알려줍니다.

new naver.maps.KVOArray(array)

Parameters
Name Type Description
array array

KVOArray로 사용할 배열

Tutorials

Extends

Methods

addListener(eventName, listener)

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

이 메서드는 EventaddListener 메서드를 상속받습니다.

Parameters
Name Type Description
eventName string

이벤트 이름

listener function

이벤트 리스너

Inherited From
Returns
Type Description
MapEventListener

지도 이벤트 리스너 객체

addListenerOnce(eventName, listener)

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

이 메서드는 Eventonce 메서드를 상속받습니다.

Parameters
Name Type Description
eventName string

이벤트 이름

listener function

이벤트 리스너

Inherited From
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
Fires

clear()

모든 요소를 삭제합니다.

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

clearListeners(eventName)

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

이 메서드는 EventclearListeners 메서드를 상속받습니다.

Parameters
Name Type Description
eventName string

모두 제거할 이벤트의 이름

Inherited From

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
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)

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

이 메서드는 EventhasListener 메서드를 상속받습니다.

Parameters
Name Type Description
eventName string

이벤트 이름

Inherited From
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)

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

이 메서드는 EventremoveListener 메서드를 상속받습니다.

Parameters
Name Type Description
listeners MapEventListener | Array.<MapEventListener>

제거할 리스너 객체 또는 리스너 객체의 배열

Inherited From

set(key, value, silently)

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

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

Parameters
Name Type Argument Description
key string

value any

키에 저장할 값

silently boolean <optional>

묵시적으로 값을 설정할지 여부. 이 값이 true이면 이벤트를 발생시키지 않습니다.

Inherited From
Fires

setAt(index, element)

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

Parameters
Name Type Description
index number

배열의 인덱스. 이 값이 현재 배열 length-1보다 크면 insertAt을 호출합니다.

element any

설정할 요소의 값

Fires

setValues(properties)

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

Parameters
Name Type Description
properties object

설정할 키-값 쌍의 객체

Inherited From
Fires

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)

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

이 메서드는 Eventtrigger 메서드를 상속받습니다.

Parameters
Name Type Argument Description
eventName string

이벤트 이름

eventObject any <optional>
<repeatable>

이벤트 리스너에 전달할 이벤트 객체

Inherited From

unbind(key)

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

Parameters
Name Type Description
key string

제거할 키

Inherited From

unbindAll()

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

Inherited From

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