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 の場合、ユーザーがキャプチャーを開始したいことを useCapture が示す。指定された型のすべてのイベントは、 キャプチャーを開始したあと、ツリーの下部にある EventTargets にディスパッチされる前に、登録された EventListener にディスパッチされる。ツリーを介して 上方へ向かってバブルしているイベントは、 キャプチャーに使用するために指定した EventListener をトリガーしない

removeEventListener

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

このメソッドでは、イベントターゲットからイベントリスナーを削除できます。イベント処理中に EventTargetから EventListenerを削除する場合、現在のアクションではトリガーされません。EventListenerは削除されたあとには呼び出しできません。
現在 EventTargetに登録されている EventListenerを識別しない引数で removeEventListenerを呼び出しても、効果はまったくありません。

パラメータ:

type - 削除される EventListener のイベントの型を 指定する

listener - EventListener パラメータは削除される EventListener を示す

useCapture - 削除される EventListener がキャプチャーするリスナーとして 登録されたかどうかを指定する。リスナーが キャプチャーする場合としない場合の 2 回登録された場合は、 別々に削除する必要がある。キャプチャーするリスナーを削除しても、 同じリスナーでキャプチャーしないバージョンにはまったく影響しない。 逆の場合も同様

dispatchEvent

boolean dispatchEvent(Event evt)
                      throws EventException

このメソッドでは、実装イベントモデルにイベントをディスパッチできます。このようにディスパッチされたイベントは、実装によって直接ディスパッチされたイベントと同じようにキャプチャーとバブリングを実行します。イベントのターゲットは dispatchEventが呼び出される EventTargetです。

パラメータ:

evt - イベント処理中に使用されるイベントの型、 動作、およびコンテキスト情報を指定する

戻り値:

dispatchEvent の戻り値は、 イベントを処理したリスナーが preventDefault を呼び出したかどうかを示す。preventDefault が呼び出された場合の値は false。そうでない場合の値は true

例外:

EventException - UNSPECIFIED_EVENT_TYPE_ERR:dispatchEvent が呼び出される前に イベントを初期化して Event の型が 指定されなかった場合。Event の型を null または空の文字列に指定しても、 この例外がトリガーされる