イベントリファレンス
イベントは、コードの実行に影響を与える可能性のある「興味深い変化」をコードに通知するために発行されます。これは、マウス操作やウィンドウのサイズ変更などのユーザー操作や、環境の変化 (バッテリー残量の低下や OS のメディアイベントなど)、その他の原因によって発行されます。
それぞれのイベントは、 Event インターフェイスに基づいたオブジェクトで表現され、何が起こったかについての情報を提供するために、追加のカスタムフィールドや関数を持つことがあります。各イベントのドキュメントには、関連するイベントインターフェイスへのリンクや、その他の関連情報を含む表が (上部付近に) あります。イベントの種類の一覧は、イベント > Event を基にしたインターフェイスにあります。
この記事では、興味のありそうな主なイベントの種類 (アニメーション、クリップボード、ワーカーなど) と、それらの種類のイベントを実装する主なクラスの索引を提供します。最後には、ドキュメント化されたすべてのイベントの一覧を掲載しています。
メモ: このページでは、ウェブ上で遭遇する最も一般的なイベントの多くをリストアップしています。ここに掲載されていないイベントを探している場合は、 MDN の他の部分でその名前、トピック領域、関連する仕様書を検索してみてください。
イベント索引
| イベントの種類 | 説明 | ドキュメント |
|---|---|---|
| アニメーション |
ウェブアニメーション API に関するイベント。 アニメーション状態の変化 (例えば、アニメーションの開始または終了) に応答するために使用される。 |
アニメーションイベントは
Document,
Window,
HTMLElement で発行される。
|
| 非同期データ読み取り | データの読み取りに関するイベント。 |
イベントは
AbortSignal,
XMLHttpRequest,
FileReader で発行される。
|
| クリップボード |
クリップボード API に関するイベント。 コンテンツが切り取り、コピー、貼り付けされたときを知るために使用。 |
イベントは
Document,
Element,
Window で発行される。
|
| 変換 |
変換、すなわち (通常のキー押下を使用しない) テキストの「間接的な」入力に関するイベント。 例えば、音声入力エンジンからのテキスト入力、他の言語の新しい文字を表現するための特殊な装飾キー入力の組み合わせ。 訳注: 日本語のかな漢字変換も含む。 |
イベントは
Element で発行される。
|
| CSS トランジション |
CSS トランジションに関するイベント。 CSS トランジションの開始、終了、キャンセルなどの時の通知イベントを提供する。 |
イベントは Document,
HTMLElement,
Window で発行される。
|
| データベース |
データベース操作時、開く、閉じる、トランザクション、エラーなどに関するイベント。 |
イベントは
IDBDatabase,
IDBOpenDBRequest,
IDBRequest,
IDBTransaction で発行される。
|
| DOM 変化 |
Document Object Model (DOM) 階層やノードに対する変更に関するイベント。 |
警告: Mutation イベントは非推奨です。 代わりに Mutation Observer を使用してください。 |
| ドラッグ＆ドロップ、ホイール |
HTML ドラッグ＆ドロップ API に関するイベントやホイールイベント。 ドラッグイベントやホイールイベントは、マウスイベントから派生したものです。これらのイベントは、マウスホイールやドラッグ/ドロップを使用したときに発行されますが、他の適切なハードウェアでも使用されることがあります。 |
ドラッグイベントは
ホイールイベントは
|
| フォーカス | 要素がフォーカスを得たり失ったりすることに関するイベント。 |
イベントは Element,
Window で発行される。
|
| フォーム |
フォームが構築されたり、リセットされたり、送信されたりすることに関するイベント。 |
イベントは
HTMLFormElement で発行される。
|
| 全画面 |
全画面 API に関するイベント。 全画面モードとウィンドウモードの間で遷移したとき、この遷移の間でエラーが発生したときの通知に使用。 |
イベントは
Document,
Element で発行される。
|
| ゲームパッド |
ゲームパッド API に関するイベント。 |
イベントは
Window で発行される。
|
| ジェスチャー |
ジェスチャーの実装にはタッチイベントが推奨されます。 |
イベントは
加えて、いくつもの標準外のジェスチャーイベントが存在する。
|
| 履歴 |
履歴 API に関するイベント。 |
イベントは
Window で発行される。
|
| HTML 要素コンテンツの表示管理 |
表示またはテキスト要素の状態の変更に関するイベント。 |
イベントは
HTMLDetailsElement,
HTMLDialogElement,
HTMLSlotElement で発行される。
|
| 入力 |
HTML の input 要素、例えば |
イベントは
HTMLElement,
HTMLInputElement で発行される。
|
| キーボード |
キーボードの使用に関するイベント。 キーが上がった、下がった、押された時の通知に使用する。 |
イベントは Document,
Element で発行される。
|
| 文書の読み込み/アンロード | 文書の読み込みやアンロードに関するイベント。 |
|
| マニフェスト |
プログレッシブウェブアプリのマニフェストのインストールに関するイベント。 |
イベントは
Window で発行される。
|
| メディア |
メディアの使用 (メディアキャプチャとストリーム API、 ウェブオーディオ API、 ピクチャインピクチャ API、など) に関するイベント。 |
イベントは
ScriptProcessorNode,
HTMLMediaElement,
AudioTrackList,
AudioScheduledSourceNode,
MediaRecorder,
MediaStream,
MediaStreamTrack,
VideoTrackList,
HTMLTrackElement,
OfflineAudioContext,
TextTrack,
TextTrackList,
Element/audio,
Element/video
で発行される。
|
| メッセージ |
ウィンドウが他の閲覧コンテキストからメッセージを受け取ることに関するイベント。 |
イベントは
Window で発行される。
|
| マウス |
コンピューターのマウスの使用に関するイベント。 マウスのクリック、ダブルクリック、離す、押すイベント、右クリック、要素内または要素外への移動、テキスト選択など。 ポインターイベントは、ハードウェアに依存しない、マウスイベントの代替となるものです。ドラッグイベント、ホイールイベントは、マウスイベントから派生したものです。 |
マウスイベントは
Element で発行されます。
|
| ネットワーク/接続 | ネットワーク接続が得られた、または失われたことに関するイベント。 |
イベントは
イベントは
|
| 決済 |
決済リクエスト API に関するイベント。 |
イベントは
|
| パフォーマンス |
パフォーマンス API に分類されたパフォーマンス関連仕様書に関するイベント。 |
イベントは
|
| ポインター |
ポインターイベント API に関するイベント。 マウス、タッチ、ペン/スタイラスなどのポインティングデバイスから、ハードウェアに依存しない通知を提供する。 |
イベントは
Document,
HTMLElement で発行される。
|
| 印刷 | 印刷に関するイベント。 |
イベントは
Window で発行される。
|
| プロミスの拒否 |
JavaScript のプロミスが拒否されたときにグローバルスクリプトコンテキストに送信されるイベント。 |
イベントは
Window で発行される。
|
| ソケット |
WebSockets API に関するイベント。 |
イベントは Websocket で発行される。
|
| SVG | SVG 画像に関するイベント。 |
イベントは
|
| テキスト選択 |
テキストの選択に関するイベント。 |
イベント ( |
| タッチ |
Touch Events API に関するイベント。 タッチ反応画面 (すなわち指またはスタイラスを使用したもの) の操作による通知イベントを提供する。 Force Touch API に関するものではない。 |
イベントは
Document,
Element で発行される。
|
| バーチャルリアリティ |
WebXR 機器 API に関するイベント。
警告: WebVR API (および関連する
|
イベントは
XRSystem,
XRSession,
XRReferenceSpace で発行される。
|
| RTC (リアルタイムコミュニケーション) |
WebRTC API に関するイベント。 |
イベントは
RTCDataChannel,
RTCDTMFSender,
RTCIceTransport,
RTCPeerConnection で発行される。
|
| サーバー送信イベント |
サーバー送信イベント API に関するイベント。 |
イベントは
EventSource で発行される。
|
| 発声 |
Web Speech API に関するイベント。 |
イベントは
SpeechSynthesisUtterance で発行される。
|
| ワーカー |
ウェブワーカー API, サービスワーカー API, ブロードキャストチャンネル API, チャンネルメッセージング API に関するイベント。 新しいメッセージやメッセージ送信エラーに応答するために使用されます。サービスワーカーは、プッシュ通知、表示された通知をユーザーがクリックしたこと、プッシュ購読が無効になったこと、コンテンツインデックスからアイテムが削除されたことなど、その他のイベントを通知することもできます。 |
イベントは
ServiceWorkerGlobalScope,
DedicatedWorkerGlobalScope,
SharedWorkerGlobalScope,
WorkerGlobalScope,
Worker,
BroadcastChannel,
MessagePort で発行されます。
|
仕様書
| Specification |
|---|
| HTML Standard # events-2 |