|
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 | ||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||