org.w3c.dom.events
인터페이스 EventTarget

public interface EventTarget

EventTarget인터페이스는 DOM 이벤트 모델을 지원하는 구현에서는 모든 Node에 따라서 구현됩니다. 그 때문에 Node인터페이스의 인스턴스로 바인딩에 특유의 캐스트 메서드를 사용해,이 인터페이스를 취득할 수 있습니다. 이 인터페이스에서는 EventTarget로 EventListeners를 등록, 삭제하거나EventTarget에 이벤트를 디스패치 하거나 할 수 있습니다.

「Document Object Model (DOM) Level 2 Events Specification」도 참조하십시오.

도입된 버전 :

DOM Level 2

메서드 개요

void	addEventListener (String type, EventListener listener, boolean useCapture) 이 메서드에서는 이벤트 타겟으로 이벤트 리스너를 등록할 수 있습니다.
boolean	dispatchEvent (Event evt) 이 메서드에서는 구현 이벤트 모델에 이벤트를 디스패치 할 수 있습니다.
void	removeEventListener (String type, EventListener listener, boolean useCapture) 이 메서드에서는 이벤트 타겟으로부터 이벤트 리스너를 삭제할 수 있습니다.

메서드의 상세

addEventListener

void addEventListener(String  type,
                      EventListener  listener,
                      boolean useCapture)

이 메서드에서는 이벤트 타겟으로 이벤트 리스너를 등록할 수 있습니다. 이벤트 처리중에 EventTarget에 EventListener를 추가했을 경우, 현재의 액션에서는 트리거 되지 않습니다만, 버블 국면 등, 이벤트 흐름의 뒤의 단계에서는 트리거 되는 경우가 있습니다.
복수의 같은 EventListener가 같은 파라미터를 가져 같은 EventTarget에 등록되어 있는 경우는 중복 하는 인스턴스가 파기됩니다. 이것에 의해 EventListener가 2 번 불려 갈 것은 없습니다. 중복 하는 인스턴스는 파기되기 때문에 removeEventListener메서드로 삭제할 필요는 없습니다.

파라미터:

type - 사용자가 등록하고 있는 이벤트의 형태

listener - listener 파라미터는 이벤트의 발생시에 호출되는 메서드를 포함해, 사용자에 의해 구현되는 인터페이스를 지정한다

useCapture - true 의 경우, 사용자가 capther를 개시하고 싶은 것을 useCapture 하지만 가리킨다. 지정된 형태의 모든 이벤트는 capther를 개시한뒤 트리의 하부에 있는 EventTargets에 디스패치 되기 전에 등록된 EventListener에 디스패치 된다. 트리를 개입시켜 윗쪽으로 향해 버블 하고 있는 이벤트는 capther에 사용하기 위해서 지정한 EventListener는 트리거 하지 않는다

removeEventListener

void removeEventListener(String  type,
                         EventListener  listener,
                         boolean useCapture)

이 메서드에서는 이벤트 타겟으로부터 이벤트 리스너를 삭제할 수 있습니다. 이벤트 처리중에 EventTarget로부터 EventListener를 삭제하는 경우, 현재의 액션에서는 트리거 되지 않습니다. EventListener는 삭제된 뒤에는 호출할 수 없습니다.
현재 EventTarget에 등록되어 있는 EventListener를 식별하지 않는 인수 그리고 removeEventListener를 호출해도, 효과는 전혀 없습니다.

파라미터:

type - 삭제된다 EventListener 이벤트의 형태

listener - EventListener는 삭제되는 EventListener 를 나타내는

useCapture - 삭 제 되는 EventListener 하지만 capther 하는 리스너로서 등록되었는지 어떠했는지를 지정한다. 리스너가 capther 하는 경우로 하지 않는 경우의 2 회 등록되었을 경우는 따로 따로 삭제할 필요가 있다. capther 하는 리스너를 삭제해도, 같은 리스너로 capther 하지 않는 버전에 는 완전히 영향을 주는거야 있고. 역의 경우도 마찬가지

dispatchEvent

boolean dispatchEvent(Event  evt)
                      throws EventException 

이 메서드에서는 구현 이벤트 모델에 이벤트를 디스패치 할 수 있습니다. 이와 같이 디스패치 된 이벤트는 구현에 의해 직접 디스패치 되었다이벤트와 같이 capther와 바브 링을 실행합니다. 이벤트의 타겟은 dispatchEvent이 불러 출이야 EventTarget입니다.

파라미터:

evt - 이벤트 처리 안에 사용되는 이벤트의 형태, 동작 및 컨텍스트 정보

반환값:

dispatchEvent 의 반환값은 이벤트를 처리한 리스너가 preventDefault를 호출했는지 어떠했는지를 나타낸다. preventDefault 하지만 불려 갔을 경우의 값은 false. 그렇지 않은 경우의 값은 true

예외:

EventException - UNSPECIFIED_EVENT_TYPE_ERR: dispatchEvent이 불려가기 전에 이벤트를 초기화해 Event 의 형태가 지정되지 않았던 경우. Event 형태를 null 또는 비어있는 캐릭터 라인으로 지정해도, 이 예외가 트리거 된다