Event
Event
インターフェイスは、DOM で発生するイベントを表します。ユーザーによって発生するイベント (マウスやキーボードのイベント) もありますし、API によって発生するイベント (アニメーションの実行が完了したことを示すイベントや、動画再生が一時停止したイベントなど) もあります。さまざまな型のイベントがあり、一部のイベントは基底の Event
インターフェイスを基にした他のインターフェイスを使用します。Event
自体は、すべてのイベントで共通のプロパティやメソッドを持ちます。
Event
を基にしたインターフェイス
以下のリストは Event
インターフェイスを基にしたインターフェイスの一覧であり、 MDN API リファレンスの各ドキュメントにリンクしています。すべてのイベントインターフェイスは、名称の末尾が "Event" であることに留意してください。
AnimationEvent
AudioProcessingEvent
BeforeInputEvent
BeforeUnloadEvent
(en-US)BlobEvent
ClipboardEvent
CloseEvent
CompositionEvent
CSSFontFaceLoadEvent
CustomEvent
DeviceLightEvent
DeviceMotionEvent
DeviceOrientationEvent
(en-US)DeviceProximityEvent
DOMTransactionEvent
DragEvent
EditingBeforeInputEvent
ErrorEvent
FetchEvent
FocusEvent
GamepadEvent
HashChangeEvent
(en-US)IDBVersionChangeEvent
(en-US)InputEvent
KeyboardEvent
MediaStreamEvent
(en-US)MessageEvent
MouseEvent
MutationEvent
(en-US)OfflineAudioCompletionEvent
(en-US)PageTransitionEvent
PaymentRequestUpdateEvent
(en-US)PointerEvent
PopStateEvent
(en-US)ProgressEvent
RelatedEvent
RTCDataChannelEvent
RTCIdentityErrorEvent
RTCIdentityEvent
RTCPeerConnectionIceEvent
SensorEvent
StorageEvent
SVGEvent
SVGZoomEvent
TimeEvent
(en-US)TouchEvent
TrackEvent
TransitionEvent
UIEvent
UserProximityEvent
WebGLContextEvent
(en-US)WheelEvent
コンストラクター
Event()
Event
オブジェクトを生成して、呼び出し元に返します。
プロパティ
Event.bubbles
読取専用- イベントが DOM を通して浮上 (bubble up) するかを示す boolean 値です。
Event.cancelBubble
Event.stopPropagation()
の歴史的な別名です。イベントハンドラーから戻る前に値true
を設定すると、イベントの伝播を抑制します。Event.cancelable
読取専用- イベントがキャンセル可能かを示す boolean 値です。
Event.composed
(en-US) 読取専用- shadow DOM と 通常の DOM の間の境界を越えてイベントが伝播できるかをを示す Boolean 値です。
Event.currentTarget
読取専用- イベントが現在登録されているターゲットへの参照。これは、現在イベントの送信先として予定されているオブジェクトです。これはリターゲティングによって、途中で変更できます。
Event.deepPath
(en-US)- イベントの伝播で通り抜けた DOM
Node
のArray
です。 Event.defaultPrevented
読取専用event.preventDefault()
がイベントで呼ばれたかどうかを示します。Event.eventPhase
(en-US) 読取専用- イベントの流れのうちどの段階が処理されているかを示します。
Event.explicitOriginalTarget
(en-US) 読取専用- イベントの明確な最初のターゲット (Mozilla 特有)。
Event.originalTarget
(en-US) 読取専用- イベントの再ターゲット前の最初のターゲット (Mozilla 特有)。
Event.returnValue
(en-US)- Internet Explorer によって導入された歴史的なプロパティで、既存のサイトが動作し続けることを保証するために結果的に DOM 仕様書に導入されたものです。理想的には、
Event.preventDefault()
およびEvent.defaultPrevented
を代わりに使用してみるべきですが、選択次第ではreturnValue
を使用することができます。 Event.srcElement
(en-US)Event.target
の、(古いバージョンの Microsoft Internet Explorer 由来の) 標準外の別名であり、ウェブの互換性の目的で一部の他のブラウザーでも対応が始められています。Event.target
読取専用- イベントが最初に送出されたターゲットへの参照。
Event.timeStamp
読取専用- イベントが生成された時刻をミリ秒単位で示します。仕様書ではこの値をエポックから経過した時間としていますが、実際のブラウザの定義は異なります。また、値を
DOMHighResTimeStamp
に変更する作業が進行中です。 Event.type
読取専用- イベントの名前 (大文字小文字を区別しません)。
Event.isTrusted
(en-US) 読取専用- イベントがブラウザーによって開始されたか (たとえばユーザークリックの後)、または、スクリプトによって開始されたか (event.initEvent のようなイベントを作るメソッドの使用) どうかを示します。
廃止されたプロパティ
Event.scoped
(en-US) 読取専用Boolean
で、指定されたイベントが標準 DOM の中のシャドウルートを通してバブルするかどうかを示します。このプロパティはcomposed
(en-US) に改名されました。
メソッド
Event.createEvent()
-
新しいイベントを作成し、これはその後で
initEvent()
メソッドを呼び出すことで初期化する必要があります。 Event.composedPath()
(en-US)- (リスナーが呼び出されるオブジェクトへの) イベントのパスを返します。これはシャドウルートが
ShadowRoot.mode
(en-US) が閉じた状態で作成されたシャドウツリーのノードを含みません。
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 の定義 |
現行の標準 |
ブラウザーの対応
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
関連情報
- 利用できるイベントのタイプ: イベントリファレンス
- イベントターゲットの比較 (en-US) (target vs currentTarget vs relatedTarget vs originalTarget)
- カスタムイベントの作成と発火 (en-US)
- Firefox アドオン開発者向け: