JavaScript

Event

　Eventインターフェイスは、DOMで発生するイベントを表します。ユーザーによって発生するイベント（マウスやキーボードのイベント）もありますし、APIによって発生するイベント（アニメーションの実行が完了したことを示すイベントや、動画再生が一時停止したイベントなど）もあります。さまざまな型のイベントがあり、一部のイベントは基底の Eventインターフェイスを基にした他のインターフェイスを使用します。Event自体は、すべてのイベントで共通のプロパティやメソッドを持ちます。

Event を基にしたインターフェイス

　以下のリストは Eventインターフェイスを基にしたインターフェイスの一覧です。すべてのイベントインターフェイスは、名称の末尾が "Event" であることに留意してください。

コンストラクター

Event()
Eventオブジェクトを生成して、呼び出し元に返します。

プロパティ

Event.bubbles 【読取専用】
イベントが DOMを通して浮上（bubble up）するかを示す boolean値です。
Event.cancelBubble
Event.stopPropagation()の歴史的な別名です。イベントハンドラーから戻る前に値 trueを設定すると、イベントの伝播を抑制します。
Event.cancelable 【読取専用】
イベントがキャンセル可能かを示す boolean値です。
Event.composed 【読取専用】
shadow DOMと 通常の DOMの間の境界を越えてイベントが伝播できるかをを示す Boolean値です。
Event.currentTarget 【読取専用】
イベントが現在登録されているターゲットへの参照。これは、現在イベントの送信先として予定されているオブジェクトです。これはリターゲティングによって、途中で変更できます。
Event.deepPath
イベントの伝播で通り抜けた DOM Nodeの Arrayです。
Event.defaultPrevented 【読取専用】
event.preventDefault()がイベントで呼ばれたかどうかを示します。
Event.eventPhase 【読取専用】
イベントの流れのうちどの段階が処理されているかを示します。
Event.explicitOriginalTarget 【読取専用】
イベントの明確な最初のターゲット。（Mozilla 特有）
Event.originalTarget 【読取専用】
イベントの再ターゲット前の最初のターゲット。（Mozilla 特有）
Event.returnValue
Internet Explorerによって導入された歴史的なプロパティで、既存のサイトが動作し続けることを保証するために結果的に DOM仕様書に導入されたものです。理想的には、 Event.preventDefault()および Event.defaultPreventedを代わりに使用してみるべきですが、選択次第では returnValueを使用することができます。
Event.srcElement
Event.targetの、（古いバージョンの Microsoft Internet Explorer由来の）標準外の別名であり、ウェブの互換性の目的で一部の他のブラウザーでも対応が始められています。
Event.target 【読取専用】
イベントが最初に送出されたターゲットへの参照。
Event.timeStamp 【読取専用】
イベントが生成された時刻をミリ秒単位で示します。仕様書ではこの値をエポックから経過した時間としていますが、実際のブラウザの定義は異なります。また、値を DOMHighResTimeStamp に変更する作業が進行中です。
Event.type 【読取専用】
イベントの名前。（大文字小文字を区別しません）
Event.isTrusted 【読取専用】
イベントがブラウザーによって開始されたか（たとえばユーザークリックの後）、または、スクリプトによって開始されたか（event.initEventのようなイベントを作るメソッドの使用）どうかを示します。

廃止されたプロパティ

Event.scoped 【読取専用】
Booleanで、指定されたイベントが標準 DOMの中のシャドウルートを通してバブルするかどうかを示します。このプロパティは composedに改名されました。

メソッド

Event.createEvent()
新しいイベントを作成し、これはその後で initEvent() メソッドを呼び出すことで初期化する必要があります。
Event.composedPath()
（リスナーが呼び出されるオブジェクトへの）イベントのパスを返します。これはシャドウルートが ShadowRoot.modeが閉じた状態で作成されたシャドウツリーのノードを含みません。
Event.initEvent()
生成されたイベントの値を初期化します。イベントがすでにディスパッチされている場合は、何も行いません。
Event.preventDefault()
イベントをキャンセルします。（キャンセル可能な場合のみ）
Event.stopImmediatePropagation()
この特定のイベントのために、他のいかなるリスナーも呼び出されません。同じ要素に付けられたリスナーも、後で横断される（たとえばキャプチャー段階の）要素に付けられたリスナーも呼び出されません。
Event.stopPropagation()
これ以上イベントが 伝播（propagation）するのを停止します。

廃止されたメソッド

Event.getPreventDefault()
標準外です。Event.defaultPreventedの値を返します。代わりに Event.defaultPreventedを使用してください。
Event.preventBubble() 【Gecko 24で廃止】
イベントが浮上（bubble up）しないようにします。廃止されたので、代わりに event.stopPropagationを使ってください。
Event.preventCapture() 【Gecko 24で廃止】
廃止されたので、event.stopPropagationを使ってください。