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 または空の文字列に指定しても、この例外がトリガされる