new naver.maps.KVOArray(array)
Parameters
Name | Type | Description |
---|---|---|
array |
array |
|
- Tutorials
Extends
Methods
-
addListener(eventName, listener)
-
현재 객체의 이벤트 알림을 받아 핸들러를 호출하는 리스너를 등록합니다.
이 메서드는 Event의
addListener
메서드를 상속받습니다.Parameters
Name Type Description eventName
string 이벤트 이름
listener
function 이벤트 리스너
- Inherited From
Returns
Type Description MapEventListener
지도 이벤트 리스너 객체
-
addListenerOnce(eventName, listener)
-
현재 객체에서 한 번만 이벤트 알림을 받아 핸들러를 호출하는 리스너를 등록합니다.
이 메서드는 Event의
once
메서드를 상속받습니다.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)
-
현재 객체에서 특정 이벤트 알림의 리스너를 모두 제거합니다.
이 메서드는 Event의
clearListeners
메서드를 상속받습니다.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)
-
현재 객체에 이벤트 알림이 등록되었는지 여부를 확인합니다.
이 메서드는 Event의
hasListener
메서드를 상속받습니다.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)
-
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
-
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)
-
현재 객체에 이벤트 알림을 발생시킵니다.
이 메서드는 Event의
trigger
메서드를 상속받습니다.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