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

Class: naver.maps.KVO

naver.maps. KVO

KVO 클래스는 KVO(Key-Value Observing) 패턴을 정의하는 클래스입니다.

이 클래스는 Event의 구현 일부를 상속받으며, NAVER 지도 API v3의 주요 클래스는 이 클래스를 상속받아 구현되었습니다.

NAVER 지도 API v3 사용자는 이 클래스를 이용해 KVO 패턴을 동일하게 사용할 수 있습니다.

new naver.maps.KVO()

Tutorials

Methods

addListener(eventName, listener)

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

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

Parameters
Name Type Description
eventName string

이벤트 이름

listener function

이벤트 리스너

Returns
Type Description
MapEventListener

지도 이벤트 리스너 객체

addListenerOnce(eventName, listener)

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

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

Parameters
Name Type Description
eventName string

이벤트 이름

listener function

이벤트 리스너

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>

대상 객체에 존재하는 키

Fires

clearListeners(eventName)

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

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

Parameters
Name Type Description
eventName string

모두 제거할 이벤트의 이름

get(key)

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

Parameters
Name Type Description
key string

Returns
Type Description
any

키에 할당되어 있는 값

hasListener(eventName)

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

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

Parameters
Name Type Description
eventName string

이벤트 이름

Returns
Type Description
boolean

등록 여부

removeListener(listeners)

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

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

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

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

set(key, value, silently)

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

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

Parameters
Name Type Argument Description
key string

value any

키에 저장할 값

silently boolean <optional>

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

Fires

setValues(properties)

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

Parameters
Name Type Description
properties object

설정할 키-값 쌍의 객체

Fires

trigger(eventName, eventObject)

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

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

Parameters
Name Type Argument Description
eventName string

이벤트 이름

eventObject any <optional>
<repeatable>

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

unbind(key)

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

Parameters
Name Type Description
key string

제거할 키

unbindAll()

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

Events

{key}_changed

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

Parameters
Name Type Description
value any

해당 키의 변경된 값