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