イベントリファレンス

イベントは、コードの実行に影響を与える可能性のある「興味深い変化」をコードに通知するために発行されます。これは、マウス操作やウィンドウのサイズ変更などのユーザー操作や、環境の変化 (バッテリー残量の低下や OS のメディアイベントなど)、その他の原因によって発行されます。

それぞれのイベントは、 Event インターフェイスに基づいたオブジェクトで表現され、何が起こったかについての情報を提供するために、追加のカスタムフィールドや関数を持つことがあります。各イベントのドキュメントには、関連するイベントインターフェイスへのリンクや、その他の関連情報を含む表が (上部付近に) あります。イベントの種類の一覧は、イベント > Event を基にしたインターフェイスにあります。

この記事では、興味のありそうな主なイベントの種類 (アニメーション、クリップボード、ワーカーなど) と、それらの種類のイベントを実装する主なクラスの索引を提供します。最後には、ドキュメント化されたすべてのイベントの一覧を掲載しています。

メモ: このページでは、ウェブ上で遭遇する最も一般的なイベントの多くをリストアップしています。ここに掲載されていないイベントを探している場合は、 MDN の他の部分でその名前、トピック領域、関連する仕様書を検索してみてください。

イベント索引

イベントの種類 説明 ドキュメント
アニメーション

Web Animation API に関するイベント。

アニメーション状態の変化 (例えば、アニメーションの開始または終了) に応答するために使用される。

 アニメーションイベントは Document, Window, HTMLElement で発行される。
非同期データ読み取り

データの読み取りに関するイベント。

 イベントは AbortSignal, XMLHttpRequest, FileReader で発行される。
クリップボード

Clipboard API に関するイベント。

コンテンツが切り取り、コピー、貼り付けされたときを知るために使用。

 イベントは Document, Element, Window で発行される。
変換

変換、すなわち (通常のキー押下を使用しない) テキストの「間接的な」入力に関するイベント。

例えば、音声入力エンジンからのテキスト入力、他の言語の新しい文字を表現するための特殊な装飾キー入力の組み合わせ。

訳注: 日本語のかな漢字変換も含む。

 イベントは Element で発行される。
CSS トランジション

CSS トランジションに関するイベント。

CSS トランジションの開始、終了、キャンセルなどの時の通知イベントを提供する。

 イベントは Document, HTMLElement, Window で発行される。
データベース

データベース操作時、開く、閉じる、トランザクション、エラーなどに関するイベント。

 イベントは IDBDatabase, IDBOpenDBRequest, IDBRequest, IDBTransaction で発行される。
DOM 変化

Document Object Model (DOM) 階層やノードに対する変更に関するイベント。

警告: Mutation イベントは非推奨です。 代わりに Mutation Observer を使用してください。

ドラッグ＆ドロップ、ホイール

HTML Drag and Drop API に関するイベントやホイールイベント。

ドラッグイベントやホイールイベントは、マウスイベントから派生したものです。これらのイベントは、マウスホイールやドラッグ/ドロップを使用したときに発行されますが、他の適切なハードウェアでも使用されることがあります。

ドラッグイベントは Document で発行される。

ホイールイベントは Document (en-US) および Element で発行される。
フォーカス

要素がフォーカスを得たり失ったりすることに関するイベント。

 イベントは Element, Window で発行される。
フォーム

フォームが構築されたり、リセットされたり、送信されたりすることに関するイベント。

 イベントは HTMLFormElement で発行される。
全画面

Fullscreen API に関するイベント。

全画面モードとウィンドウモードの間で遷移したとき、この遷移の間でエラーが発生したときの通知に使用。

 イベントは Document, Element で発行される。
ゲームパッド

Gamepad API に関するイベント。

 イベントは Window で発行される。
ジェスチャー

ジェスチャーの実装にはタッチイベントが推奨されます。

イベントは Document, Element で発行される。

加えて、いくつもの標準外のジェスチャーイベントが存在する。
履歴

History API に関するイベント。

 イベントは Window で発行される。
HTML 要素コンテンツの表示管理

表示またはテキスト要素の状態の変更に関するイベント。

 イベントは HTMLDetailsElement, HTMLDialogElement, HTMLSlotElement で発行される。
入力

HTML の input 要素、例えば <input>, <select>, <textarea> に関するイベント。

 イベントは HTMLElement, HTMLInputElement で発行される。
キーボード

キーボードの使用に関するイベント。

キーが上がった、下がった、押された時の通知に使用する。

 イベントは Document, Element で発行される。
文書の読み込み/アンロード

文書の読み込みやアンロードに関するイベント。

イベントは Document や Window で発行される。
マニフェスト

プログレッシブウェブアプリのマニフェストのインストールに関するイベント。

 イベントは Window で発行される。
メディア

メディアの使用 (Media Capture and Streams API, Web Audio API, Picture-in-Picture API, など) に関するイベント。

 イベントは ScriptProcessorNode, HTMLMediaElement, AudioTrackList, AudioScheduledSourceNode, MediaRecorder, MediaStream, MediaStreamTrack, VideoTrackList, HTMLTrackElement, OfflineAudioContext, TextTrack, TextTrackList (en-US), Element/audio, Element/video で発行される。
メッセージ

ウィンドウが他の閲覧コンテキストからメッセージを受け取ることに関するイベント。

 イベントは Window で発行される。
マウス

コンピューターのマウスの使用に関するイベント。

マウスのクリック、ダブルクリック、離す、押すイベント、右クリック、要素内または要素外への移動、テキスト選択など。

ポインターイベントは、ハードウェアに依存しない、マウスイベントの代替となるものです。ドラッグイベント、ホイールイベントは、マウスイベントから派生したものです。

 マウスイベントは Element で発行されます。
ネットワーク/接続

ネットワーク接続が得られた、または失われたことに関するイベント。

イベントは Window で発行される。

イベントは NetworkInformation (Network Information API) で発行される。
支払い

Payment Request API に関するイベント。

イベントは PaymentRequest, PaymentResponse (en-US) で発行される。
パフォーマンス

High Resolution Time API, Performance Timeline API, Navigation Timing API, User Timing API (en-US), and Resource Timing API に関するイベント。

イベントは Performance で発行される。
ポインター

Pointer Events API に関するイベント。

マウス、タッチ、ペン/スタイラスなどのポインティングデバイスから、ハードウェアに依存しない通知を提供する。

 イベントは Document, HTMLElement で発行される。
印刷

印刷に関するイベント。

 イベントは Window で発行される。
プロミスの拒否

JavaScript のプロミスが拒否されたときにグローバルスクリプトコンテキストに送信されるイベント。

 イベントは Window で発行される。
ソケット

WebSockets API に関するイベント。

 イベントは Websocket で発行される。
SVG

SVG 画像に関するイベント。

イベントは SVGElement, SVGAnimationElement (en-US), SVGGraphicsElement で発行される。
テキスト選択

テキストの選択に関するイベント。

イベントは Document で発行
タッチ

Touch Events API に関するイベント。

タッチ反応画面 (すなわち指またはスタイラスを使用したもの) の操作による通知イベントを提供する。 Force Touch API (en-US) に関するものではない。

 イベントは Document, Element で発行される。
バーチャルリアリティ

WebXR Device API に関するイベント。

警告: WebVR API (および関連する Window イベント) は非推奨です。

 イベントは XRSystem, XRSession (en-US), XRReferenceSpace で発行される。
RTC (リアルタイムコミュニケーション)

WebRTC API に関するイベント。

 イベントは RTCDataChannel, RTCDTMFSender (en-US), RTCIceTransport (en-US), RTCPeerConnection で発行される。
サーバー送信イベント

server sent events API に関するイベント。

 イベントは EventSource で発行される。
発声

Web Speech API に関するイベント。

 イベントは SpeechSynthesisUtterance で発行される。
ワーカー

Web Workers API, Service Worker API, Broadcast Channel API, Channel Messaging API に関するイベント。

新しいメッセージやメッセージ送信エラーに応答するために使用されます。サービスワーカーは、プッシュ通知、表示された通知をユーザーがクリックしたこと、プッシュ購読が無効になったこと、コンテンツインデックスからアイテムが削除されたことなど、その他のイベントを通知することもできます。

 イベントは ServiceWorkerGlobalScope, DedicatedWorkerGlobalScope, SharedWorkerGlobalScope, WorkerGlobalScope, Worker, WorkerGlobalScope, BroadcastChannel, MessagePort で発行されます。

イベントの一覧

この節では、 MDN に独自のリファレンスページを持つイベントをリストアップしています。ここに掲載されていないイベントに興味がある場合は、 MDN の他の部分でその名前、トピック領域、または関連する仕様書を検索してみてください。

仕様書

Specification
HTML Standard
# events-2