Event
インターフェイスは、DOM で発生するイベントを表します。ユーザーによって発生するイベント (マウスやキーボードのイベント) もありますし、API によって発生するイベント (アニメーションの実行が完了したことを示すイベントや、動画再生が一時停止したイベントなど) もあります。さまざまな型のイベントがあり、一部のイベントは基底の Event
インターフェイスを基にした他のインターフェイスを使用します。Event
自体は、すべてのイベントで共通のプロパティやメソッドを持ちます。
Event
を基にしたインターフェイス
以下のリストは Event
インターフェイスを基にしたインターフェイスの一覧であり、 MDN API リファレンスの各ドキュメントにリンクしています。すべてのイベントインターフェイスは、名称の末尾が "Event" であることに留意してください。
AnimationEvent
AudioProcessingEvent
BeforeInputEvent
BeforeUnloadEvent
BlobEvent
ClipboardEvent
CloseEvent
CompositionEvent
CSSFontFaceLoadEvent
CustomEvent
DeviceLightEvent
DeviceMotionEvent
DeviceOrientationEvent
DeviceProximityEvent
DOMTransactionEvent
DragEvent
EditingBeforeInputEvent
ErrorEvent
FetchEvent
FocusEvent
GamepadEvent
HashChangeEvent
IDBVersionChangeEvent
InputEvent
KeyboardEvent
MediaStreamEvent
MessageEvent
MouseEvent
MutationEvent
OfflineAudioCompletionEvent
PageTransitionEvent
PaymentRequestUpdateEvent
PointerEvent
PopStateEvent
ProgressEvent
RelatedEvent
RTCDataChannelEvent
RTCIdentityErrorEvent
RTCIdentityEvent
RTCPeerConnectionIceEvent
SensorEvent
StorageEvent
SVGEvent
SVGZoomEvent
TimeEvent
TouchEvent
TrackEvent
TransitionEvent
UIEvent
UserProximityEvent
WebGLContextEvent
WheelEvent
コンストラクター
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
を使ってください。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
DOM Event の定義 |
現行の標準 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
デスクトップ | モバイル | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Event | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 あり | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
Event() constructor | Chrome 完全対応 15 | Edge 完全対応 あり | Firefox 完全対応 11 | IE 未対応 なし | Opera 完全対応 11.6 | Safari 完全対応 6 | WebView Android 完全対応 あり | Chrome Android 完全対応 18 | Firefox Android 完全対応 14 | Opera Android 完全対応 12 | Safari iOS 完全対応 6 | Samsung Internet Android ? |
bubbles | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE ? | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
cancelable | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE ? | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
cancelBubble | Chrome
完全対応
あり
| Edge 完全対応 12 | Firefox
完全対応
53
| IE 完全対応 あり | Opera
完全対応
あり
| Safari 完全対応 あり | WebView Android
完全対応
あり
| Chrome Android
完全対応
あり
| Firefox Android
完全対応
53
| Opera Android
完全対応
あり
| Safari iOS 完全対応 あり | Samsung Internet Android ? |
composed | Chrome 完全対応 53 | Edge 未対応 なし | Firefox 完全対応 52 | IE 未対応 なし | Opera 完全対応 40 | Safari 完全対応 あり | WebView Android 完全対応 53 | Chrome Android 完全対応 53 | Firefox Android 完全対応 52 | Opera Android 完全対応 41 | Safari iOS 完全対応 あり | Samsung Internet Android ? |
composedPath | Chrome
完全対応
53
| Edge 未対応 なし | Firefox 完全対応 52 | IE 未対応 なし | Opera
完全対応
40
| Safari 完全対応 10 | WebView Android
完全対応
53
| Chrome Android
完全対応
53
| Firefox Android 完全対応 52 | Opera Android
完全対応
41
| Safari iOS 完全対応 10 | Samsung Internet Android ? |
createEvent | Chrome 未対応 なし | Edge ? | Firefox ? | IE ? | Opera 未対応 なし | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android ? | Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
currentTarget | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE
完全対応
9
| Opera 完全対応 あり | Safari 完全対応 10 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 10 | Samsung Internet Android ? |
defaultPrevented | Chrome 完全対応 18 | Edge 完全対応 12 | Firefox 完全対応 6 | IE 完全対応 9 | Opera 完全対応 11 | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 18 | Firefox Android 完全対応 6 | Opera Android 完全対応 11 | Safari iOS 完全対応 5 | Samsung Internet Android ? |
eventPhase | Chrome 完全対応 45 | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 9 | Opera 完全対応 32 | Safari 完全対応 あり | WebView Android 完全対応 45 | Chrome Android 完全対応 45 | Firefox Android 完全対応 あり | Opera Android 完全対応 32 | Safari iOS 完全対応 あり | Samsung Internet Android ? |
explicitOriginalTarget | Chrome 未対応 なし | Edge 未対応 なし | Firefox 完全対応 あり | IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android 完全対応 あり | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
getPreventDefault | Chrome 未対応 なし | Edge ? | Firefox
未対応
? — 59
| IE ? | Opera 未対応 なし | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android
未対応
? — 59
| Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
initEvent | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox
完全対応
17
| IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android
完全対応
17
| Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
isTrusted | Chrome
完全対応
46
| Edge 完全対応 12 | Firefox 完全対応 あり | IE
未対応
なし
| Opera
完全対応
33
| Safari 完全対応 10 | WebView Android
完全対応
46
| Chrome Android
完全対応
46
| Firefox Android 完全対応 あり | Opera Android
完全対応
33
| Safari iOS 完全対応 10 | Samsung Internet Android ? |
originalTarget | Chrome 未対応 なし | Edge 未対応 なし | Firefox 完全対応 あり | IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android 完全対応 あり | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
preventBubble | Chrome 未対応 なし | Edge ? | Firefox 未対応 ? — 24 | IE ? | Opera 未対応 なし | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android 未対応 ? — 24 | Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
preventCapture | Chrome 未対応 なし | Edge ? | Firefox 未対応 ? — 24 | IE ? | Opera 未対応 なし | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Firefox Android 未対応 ? — 24 | Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
preventDefault | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 9 | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
returnValue | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox
未対応
なし
| IE 完全対応 6 | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android
未対応
なし
| Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
srcElement | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 62 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 62 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
stopImmediatePropagation | Chrome 完全対応 6 | Edge 完全対応 12 | Firefox 完全対応 10 | IE 完全対応 9 | Opera 完全対応 15 | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 18 | Firefox Android 完全対応 10 | Opera Android 完全対応 14 | Safari iOS 完全対応 5 | Samsung Internet Android ? |
stopPropagation | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 9 | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
target | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
timeStamp | Chrome
完全対応
49
| Edge 完全対応 12 | Firefox
完全対応
あり
| IE
完全対応
あり
| Opera
完全対応
36
| Safari 完全対応 あり | WebView Android
完全対応
49
| Chrome Android
完全対応
49
| Firefox Android
完全対応
あり
| Opera Android
完全対応
36
| Safari iOS 完全対応 あり | Samsung Internet Android ? |
type | Chrome 完全対応 45 | Edge 完全対応 12 | Firefox 完全対応 あり | IE ? | Opera 完全対応 32 | Safari 完全対応 あり | WebView Android 完全対応 45 | Chrome Android 完全対応 45 | Firefox Android 完全対応 あり | Opera Android 完全対応 32 | Safari iOS 完全対応 あり | Samsung Internet Android ? |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非推奨。新しいウェブサイトでは使用しないでください。
- 非推奨。新しいウェブサイトでは使用しないでください。
- 実装ノートを参照してください。
- 実装ノートを参照してください。
- 非標準の名前を使用しています。
- 非標準の名前を使用しています。
関連情報
- 利用できるイベントのタイプ: イベントリファレンス
- イベントターゲットの比較 (target vs currentTarget vs relatedTarget vs originalTarget)
- カスタムイベントの作成と発火
- Firefox アドオン開発者向け: