|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Event
インタフェースは、イベントを処理するハンドラにイベントに
関するコンテキスト情報を提供するために使用します。Event
インタフェースを実装しているオブジェクトは、一般に、イベントハンドラに対する
最初のパラメータとして引き渡します。さらに具体的なコンテキスト情報は、
Event
から追加のインタフェースを派生させることにより、
イベントハンドラに引き渡します。その追加インタフェースには、付随しているイベントの
型に直接関連した情報が含まれます。これらの派生インタフェースは、イベントリスナー
に引き渡されるオブジェクトによっても実装されます。
「Document Object Model (DOM) Level 2 Events Specification」も参照してください。
フィールドの概要 | |
static short |
AT_TARGET
イベントは、ターゲットの EventTarget で評価されている最中です。 |
static short |
BUBBLING_PHASE
現在のイベントフェーズは、バブルフェーズです。 |
static short |
CAPTURING_PHASE
現在のイベントフェーズは、キャプチャフェーズです。 |
メソッドの概要 | |
boolean |
getBubbles()
イベントがバブルイベントであるかどうかを知らせるために使用します。 |
boolean |
getCancelable()
イベントのデフォルトのアクションを阻止できるかどうかを知らせるために使用します。 |
EventTarget |
getCurrentTarget()
EventTarget のうち、EventListeners が現在処理中の
ものを知らせるために使用します。 |
short |
getEventPhase()
イベントフローのどのフェーズが現在評価されているかを知らせるために使用します。 |
EventTarget |
getTarget()
イベントが最初にディスパッチされた EventTarget を知らせるために
使用します。 |
long |
getTimeStamp()
イベントが作成された時刻 (基準日時からのミリ秒数) を示すために使用します。 |
String |
getType()
イベントの名前です (大文字小文字は区別されない)。 |
void |
initEvent(String eventTypeArg,
boolean canBubbleArg,
boolean cancelableArg)
initEvent メソッドは、DocumentEvent インタフェースを
介して作成された Event の値を初期化するために使用します。
|
void |
preventDefault()
イベントがキャンセル可能な場合、 preventDefault メソッドを使用すると
イベントのキャンセルを通知できるため、そのイベントの結果として通常は実装により
実行されるデフォルトのアクションが実行されません。 |
void |
stopPropagation()
stopPropagation メソッドは、イベントフローにおいてこれ以上イベントが
伝えられるのを止めるために使用します。 |
フィールドの詳細 |
public static final short CAPTURING_PHASE
public static final short AT_TARGET
EventTarget
で評価されている最中です。
public static final short BUBBLING_PHASE
メソッドの詳細 |
public String getType()
public EventTarget getTarget()
EventTarget
を知らせるために
使用します。
public EventTarget getCurrentTarget()
EventTarget
のうち、EventListeners
が現在処理中の
ものを知らせるために使用します。これは、キャプチャ中およびバブル中に、特に便利
です。
public short getEventPhase()
public boolean getBubbles()
public boolean getCancelable()
public long getTimeStamp()
timeStamp
の値を利用できない
イベントもあります。この値を利用できない場合、0 という値が返されます。基準日時の
例としては、システムが始動した日時や、1970 年 1 月 1 日の 0 時 0 分 0 秒 (協定世界時)
があります。
public void stopPropagation()
stopPropagation
メソッドは、イベントフローにおいてこれ以上イベントが
伝えられるのを止めるために使用します。EventListener
によって
このメソッドが呼び出されると、そのイベントはツリーをたどって伝えられなくなります。
イベントフローが停止する前に、現在の EventTarget
上のすべての
リスナーに対するイベントのディスパッチが完了します。このメソッドは、イベントフロー
のどの段階でも使用できます。
public void preventDefault()
preventDefault
メソッドを使用すると
イベントのキャンセルを通知できるため、そのイベントの結果として通常は実装により
実行されるデフォルトのアクションが実行されません。イベントフローのどの段階で
preventDefault
メソッドが呼び出されても、そのイベントはキャンセル
されます。そのイベントに関連付けられているデフォルトのアクションは実行され
ません。キャンセル可能ではないイベントに対してこのメソッドを呼び出しても、
何も効果がありません。いったん preventDefault
が呼び出されると、
イベント伝播の残り全体でその効果が有効になります。このメソッドは、イベントフロー
のどの段階でも使用できます。
public void initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg)
initEvent
メソッドは、DocumentEvent
インタフェースを
介して作成された Event
の値を初期化するために使用します。
このメソッドは、dispatchEvent
メソッドによって Event
をディスパッチする前にのみ呼び出すことができます。ただし、必要なら、初期化
フェーズ中に 2 回以上呼び出すことができます。このメソッドを 2 回以上呼び出した
場合、最後の呼び出しが優先されます。Event
インタフェースの
サブクラスからこのメソッドを呼び出した場合は、initEvent
メソッドに
指定した値だけが変更され、その他の属性は変更されないままになります。
eventTypeArg
- イベントの型を指定するこの仕様で現在定義されている
任意のイベント型、または新しいイベント型を指定できる。文字列は、XML の名前に
する必要がある。新しいイベント型の先頭は、文字列 "DOM" (大文字小文字の
すべての組み合わせを含む) であってはならない。この接頭辞は、将来の DOM イベント
セットのために予約されている。さらに、独自のイベントを追加するサードパーティは、
それぞれ独自の接頭辞を使用することで混乱を避け、ほかの新しいイベントと衝突する
可能性を抑えることが強く推奨されているcanBubbleArg
- イベントがバブルできるかどうかを指定するcancelableArg
- デフォルトのアクションを阻止できるかどうかを指定する
|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |