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