|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
EventTarget
インタフェースは、DOM イベントモデルをサポートする
実装において、すべての Nodes
によって実装されます。したがって、
このインタフェースは、Node
インタフェースのインスタンスに対して
バインディング固有のキャストメソッドを使用することによって取得できます。この
インタフェースでは、EventTarget
上の EventListeners
の登録と削除、およびその EventTarget
に対するイベントの
ディスパッチを実行できます。
「Document Object Model (DOM) Level 2 Events Specification」も参照してください。
メソッドの概要 | |
void |
addEventListener(String type,
EventListener listener,
boolean useCapture)
このメソッドでは、イベントターゲットにイベントリスナーを登録できます。 |
boolean |
dispatchEvent(Event evt)
このメソッドでは、実装のイベントモデルにイベントをディスパッチできます。 |
void |
removeEventListener(String type,
EventListener listener,
boolean useCapture)
このメソッドでは、イベントターゲットからイベントリスナーを削除できます。 |
メソッドの詳細 |
public void addEventListener(String type, EventListener listener, boolean useCapture)
EventTarget
に対して EventListener
を
追加した場合、そのリスナーは現在のアクションによってトリガーされませんが、
イベントフローのそのあとの段階 (バブルフェーズなど) でトリガーされる可能性が
あります。
EventListener
を同じ EventTarget
に対して同じパラメータを使って登録した場合、重複するインスタンスは破棄されます。
EventListener
が 2 回呼び出されることはありません。また、重複する
インスタンスが破棄されるため、removeEventListener
メソッドで削除する
必要もありません。
type
- ユーザが登録しているイベントの型listener
- listener
パラメータには、ユーザによって実装された
インタフェースで、イベントが発生した時点で呼び出されるメソッドを含むものを指定
するuseCapture
- true の場合、useCapture
はユーザがキャプチャの
開始を希望していることを示す。キャプチャを開始したあとは、指定した型のすべての
イベントが、ツリー内の下位にある EventTargets
にディスパッチされる
より前に、登録した EventListener
にディスパッチされる。ツリーに
沿って上方へバブルしているイベントは、キャプチャを使用するように指定された
EventListener
をトリガーすることがないpublic void removeEventListener(String type, EventListener listener, boolean useCapture)
EventListener
を EventTarget
から削除した
場合、そのリスナーは現在のアクションによってトリガーされることがありません。
EventListener
は、削除されたあとは決して呼び出せません。
removeEventListener
を、EventTarget
に現在
登録されている EventListener
を指定していない引数で呼び出しても、
何も効果はありません。
type
- 削除する EventListener
のイベント型を指定するlistener
- EventListener
パラメータは、削除する
EventListener
を示すuseCapture
- 削除する EventListener
がキャプチャリスナーとして
登録されたものかどうかを指定する。リスナーを 2 回登録した場合、1 回はキャプチャ
として、もう 1 回はキャプチャとしてではなく登録したのであれば、それぞれのリスナーを
別々に削除しなければならない。また、そのような場合、キャプチャリスナーを削除
しても、非キャプチャリスナーには影響が及ばない。その逆の削除でも同様であるpublic boolean dispatchEvent(Event evt) throws EventException
dispatchEvent
が呼び出された対象の EventTarget
です。
evt
- イベントの処理で使用されるイベント型、動作、およびコンテキスト情報を
指定する
dispatchEvent
の戻り値は、イベントを処理するリスナーが
preventDefault
を呼び出したかどうかを示す。
preventDefault
が呼び出された場合の値は false、そうでない場合は
true
EventException
- UNSPECIFIED_EVENT_TYPE_ERR:dispatchEvent
メソッドが呼び出さ
れる前に、イベントの初期化によって Event
の型が指定されていな
かった場合に発生する。Event
の型を null
と指定した
場合、または空の文字列を指定した場合にも、この例外がトリガーされる
|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |