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 또는 빈 상태(empty)의 캐릭터 라인으로 지정해도, 이 예외가 트리거된다