Event インターフェイスは、DOM で発生するイベントを表します。ユーザーによって発生するイベント (マウスやキーボードのイベント) もありますし、API によって発生するイベント (アニメーションの実行が完了したことを示すイベントや、動画再生が一時停止したイベントなど) もあります。さまざまな型のイベントがあり、一部のイベントは基底の Event インターフェイスを基にした他のインターフェイスを使用します。Event 自体は、すべてのイベントで共通のプロパティやメソッドを持ちます。
Event を基にしたインターフェイス
以下のリストは Event インターフェイスを基にしたインターフェイスの一覧であり、MDN API リファレンスの各ドキュメントにリンクしています。すべてのイベントインターフェイスは、名称の末尾が "Event" であることに留意してください。
AnimationEventAudioProcessingEventBeforeInputEventBeforeUnloadEventBlobEventClipboardEventCloseEventCompositionEventCSSFontFaceLoadEventCustomEventDeviceLightEventDeviceMotionEventDeviceOrientationEventDeviceProximityEventDOMTransactionEventDragEventEditingBeforeInputEventErrorEventFetchEventFocusEventGamepadEventHashChangeEventIDBVersionChangeEventInputEventKeyboardEventMediaStreamEventMessageEventMouseEventMutationEventOfflineAudioCompletionEventPageTransitionEventPointerEventPopStateEventProgressEventRelatedEventRTCDataChannelEventRTCIdentityErrorEventRTCIdentityEventRTCPeerConnectionIceEventSensorEventStorageEventSVGEventSVGZoomEventTimeEventTouchEventTrackEventTransitionEventUIEventUserProximityEventWebGLContextEventWheelEvent
コンストラクター
Event()Eventオブジェクトを生成して、呼び出し元に返します。
プロパティ
Event.bubbles読取専用- イベントが DOM を通して 浮上 (bubble up) するかを示す boolean 値です。
Event.cancelBubbleEvent.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.returnValueEvent.preventDefault()およびEvent.defaultPreventedの、(古いバージョンの Microsoft Internet Explorer 由来の) 非標準の代替手段です。Event.scoped読取専用- イベントが shadow root を通過して標準 DOM に伝播するかを示す
Boolean値です。このプロパティはcomposedに改名されました。 Event.srcElementEvent.targetの、(古いバージョンの Microsoft Internet Explorer 由来の) 非標準の別名です。Event.target読取専用- イベントが最初に送出されたターゲットへの参照。
Event.timeStamp読取専用- イベントが生成された時刻をミリ秒単位で示します。仕様書ではこの値をエポックから経過した時間としていますが、実際のブラウザの定義は異なります。また、値を
DOMHighResTimeStampに変更する作業が進行中です。 Event.type読取専用- イベントの名前 (大文字小文字を区別しません)。
Event.isTrusted読取専用- イベントがブラウザーによって開始されたか (たとえばユーザークリックの後)、または、スクリプトによって開始されたか (event.initEvent のようなイベントを作るメソッドの使用) どうかを示します。
メソッド
Event.initEvent()- 生成されたイベントの値を初期化します。イベントがすでにディスパッチされている場合は、何も行いません。
Event.preventBubble()廃止 Gecko 24- イベントが 浮上 (bubble up) しないようにします。廃止されたので、代わりに
event.stopPropagationを使ってください。 Event.preventCapture()廃止 Gecko 24- 廃止されたので、
event.stopPropagationを使ってください。 Event.preventDefault()- イベントをキャンセルします (キャンセル可能な場合のみ)。
Event.stopImmediatePropagation()- この特定のイベントのために、他のいかなるリスナーも呼び出されません。同じ要素に付けられたリスナーも、後で横断される（たとえばキャプチャー段階の) 要素に付けられたリスナーも呼び出されません。
Event.stopPropagation()- これ以上イベントが 伝播 (propagation) するのを停止します。
Event.getPreventDefault()- 非標準です。
Event.defaultPreventedの値を返します。代わりにEvent.defaultPreventedを使用してください。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| DOM Event の定義 |
現行の標準 |
ブラウザー実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有) | (有) | (有) |
cancelBubble を Event で定義 |
? | 53 (53)[1] | ? | ? | ? |
| 機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有) | (有) | (有) |
cancelBubble を Event で定義 |
? | 53.0 (53)[1] | ? | ? | ? |
[1] Firefox 52 より前のバージョンでは、このプロパティを UIEvent インターフェイスで定義していました。詳しくは バグ 1298970 をご覧ください。
関連情報
- 利用できるイベントのタイプ: イベントリファレンス
- イベントターゲットの比較 (target vs currentTarget vs relatedTarget vs originalTarget)
- カスタムイベントの作成と発火
- Firefox アドオン開発者向け: