イベントリファレンス
==========

イベントは、コードの実行に影響を与える可能性のある「興味深い変化」をコードに通知するために発行されます。これは、マウス操作やウィンドウのサイズ変更などのユーザー操作や、環境の変化 (バッテリー残量の低下や 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` で発行される。
加えて、いくつもの標準外のジェスチャーイベントが存在する。* 標準外の WebKit 固有のイベントは `Element`: `gesturestart` イベント, `gesturechange` イベント, `gestureend` イベント。
* 標準外の IE 固有のイベントは `Element`: `MSGestureStart`, `MSGestureChange`, `MSGestureEnd`, `MSGestureHold`, `MSGestureTap`。
* 非推奨/標準外の Mozilla のタッチイベントは Touch events (Mozilla experimental) (en-US)
* Firefox アドオンのマウスジェスチャーイベント
 |
| 履歴 | 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 の他の部分でその名前、トピック領域、または関連する仕様書を検索してみてください。

* `AbortSignal`
    + abort イベント
* `AudioScheduledSourceNode`
    + ended イベント
* `AudioTrackList`
    + addtrack イベント
    + change イベント
    + removetrack イベント
* `BroadcastChannel`
    + messageerror イベント
    + message イベント
* `DedicatedWorkerGlobalScope`
    + messageerror イベント
    + message イベント
* `Document`
    + animationcancel イベント
    + animationend イベント
    + animationiteration イベント
    + animationstart イベント
    + copy イベント
    + cut イベント
    + DOMContentLoaded イベント
    + dragend イベント
    + dragenter イベント
    + dragleave イベント
    + dragover イベント
    + dragstart イベント
    + drag イベント
    + drop イベント
    + fullscreenchange イベント
    + fullscreenerror イベント
    + gotpointercapture イベント
    + keydown イベント
    + keypress イベント (en-US)
    + keyup イベント
    + lostpointercapture イベント
    + paste イベント
    + pointercancel イベント
    + pointerdown イベント
    + pointerenter イベント
    + pointerleave イベント
    + pointerlockchange イベント
    + pointerlockerror イベント
    + pointermove イベント
    + pointerout イベント
    + pointerover イベント
    + pointerup イベント
    + readystatechange イベント
    + scroll イベント
    + selectionchange イベント
    + selectstart イベント
    + touchcancel イベント
    + touchend イベント
    + touchmove イベント
    + touchstart イベント
    + transitioncancel イベント
    + transitionend イベント
    + transitionrun イベント
    + transitionstart イベント
    + visibilitychange イベント
    + wheel イベント (en-US)
* `Element`
    + afterscriptexecute イベント
    + auxclick イベント
    + beforescriptexecute イベント
    + blur イベント
    + click イベント
    + compositionend イベント
    + compositionstart イベント
    + compositionupdate イベント
    + contextmenu イベント
    + copy イベント
    + cut イベント
    + dblclick イベント
    + DOMActivate イベント
    + DOMMouseScroll イベント
    + error イベント
    + focusin イベント
    + focusout イベント
    + focus イベント
    + fullscreenchange イベント
    + fullscreenerror イベント
    + gesturechange イベント
    + gestureend イベント
    + gesturestart イベント
    + keydown イベント
    + keypress イベント
    + keyup イベント
    + mousedown イベント
    + mouseenter イベント
    + mouseleave イベント
    + mousemove イベント
    + mouseout イベント
    + mouseover イベント
    + mouseup イベント
    + mousewheel イベント
    + msContentZoom イベント
    + MSGestureChange イベント
    + MSGestureEnd イベント
    + MSGestureHold イベント
    + MSGestureStart イベント
    + MSGestureTap イベント
    + MSInertiaStart イベント
    + MSManipulationStateChanged イベント
    + paste イベント
    + scroll イベント
    + select イベント
    + show イベント
    + touchcancel イベント
    + touchend イベント
    + touchmove イベント
    + touchstart イベント
    + webkitmouseforcechanged イベント
    + webkitmouseforcedown イベント
    + webkitmouseforceup イベント
    + webkitmouseforcewillbegin イベント
    + wheel イベント
* `EventSource`
    + error イベント
    + message イベント
    + open イベント
* `FileReader`
    + abort イベント
    + error イベント
    + loadend イベント
    + loadstart イベント
    + load イベント
    + progress イベント
* `HTMLCanvasElement`
    + webglcontextcreationerror イベント
    + webglcontextlost イベント
    + webglcontextrestored イベント
* `HTMLDetailsElement`
    + toggle イベント
* `HTMLDialogElement`
    + cancel イベント
    + close イベント
* `HTMLElement`
    + animationcancel イベント
    + animationend イベント
    + animationiteration イベント
    + animationstart イベント
    + beforeinput イベント
    + change イベント
    + gotpointercapture イベント
    + input イベント
    + lostpointercapture イベント
    + pointercancel イベント
    + pointerdown イベント
    + pointerenter イベント
    + pointerleave イベント
    + pointermove イベント
    + pointerout イベント
    + pointerover イベント
    + pointerup イベント
    + transitioncancel イベント
    + transitionend イベント
    + transitionrun イベント
    + transitionstart イベント
* `HTMLFormElement`
    + formdata イベント
    + reset イベント
    + submit イベント
* `HTMLInputElement`
    + invalid イベント
    + search イベント
* `HTMLMediaElement`
    + abort イベント
    + canplaythrough イベント
    + canplay イベント
    + durationchange イベント
    + emptied イベント
    + ended イベント
    + error イベント
    + loadeddata イベント
    + loadedmetadata イベント
    + loadstart イベント
    + pause イベント
    + playing イベント
    + play イベント
    + progress イベント
    + ratechange イベント
    + seeked イベント
    + seeking イベント
    + stalled イベント
    + suspend イベント
    + timeupdate イベント
    + volumechange イベント
    + waiting イベント
* `HTMLSlotElement`
    + slotchange イベント
* `HTMLTrackElement`
    + cuechange イベント
* `HTMLVideoElement`
    + enterpictureinpicture イベント
    + leavepictureinpicture イベント
* `IDBDatabase`
    + abort イベント (en-US)
    + close イベント
    + error イベント (en-US)
    + versionchange イベント
* `IDBOpenDBRequest`
    + blocked イベント
    + upgradeneeded イベント
* `IDBRequest`
    + error イベント
    + success イベント
* `IDBTransaction`
    + abort イベント
    + complete イベント
    + error イベント
* `MediaDevices`
    + devicechange イベント
* `MediaRecorder`
    + error イベント
* `MediaStream`
    + addtrack イベント
    + removetrack イベント
* `MediaStreamTrack`
    + ended イベント
    + mute イベント
    + unmute イベント
* `MessagePort`
    + messageerror イベント
    + message イベント
* `OfflineAudioContext`
    + complete イベント
* `PaymentRequest`
    + merchantvalidation イベント
    + paymentmethodchange イベント
    + shippingaddresschange イベント
    + shippingoptionchange イベント
* `PaymentResponse` (en-US)
    + payerdetailchange イベント (en-US)
* `Performance`
    + resourcetimingbufferfull イベント
* `PictureInPictureWindow`
    + resize イベント
* `RTCDataChannel`
    + bufferedamountlow イベント (en-US)
    + close イベント (en-US)
    + closing イベント (en-US)
    + error イベント (en-US)
    + message イベント (en-US)
    + open イベント (en-US)
* `RTCDtlsTransport` (en-US)
    + error イベント (en-US)
* `RTCDTMFSender` (en-US)
    + tonechange イベント (en-US)
* `RTCIceTransport` (en-US)
    + gatheringstatechange イベント (en-US)
    + selectedcandidatepairchange イベント (en-US)
    + statechange イベント (en-US)
* `RTCPeerConnection`
    + addstream イベント (en-US)
    + connectionstatechange イベント (en-US)
    + datachannel イベント (en-US)
    + icecandidateerror イベント (en-US)
    + icecandidate イベント (en-US)
    + iceconnectionstatechange イベント (en-US)
    + icegatheringstatechange イベント (en-US)
    + negotiationneeded イベント (en-US)
    + removestream イベント (en-US)
    + signalingstatechange イベント (en-US)
    + track イベント (en-US)
* `ScriptProcessorNode`
    + audioprocess イベント
* `ServiceWorkerContainer`
    + message イベント
* `ServiceWorkerGlobalScope`
    + activate イベント
    + contentdelete イベント
    + install イベント
    + message イベント
    + notificationclick イベント
    + pushsubscriptionchange イベント
    + push イベント
* `SharedWorkerGlobalScope`
    + connect イベント
* `SpeechRecognition`
    + audioend イベント
    + audiostart イベント
    + end イベント
    + error イベント
    + nomatch イベント
    + result イベント
    + soundend イベント
    + soundstart イベント
    + speechend イベント
    + speechstart イベント
    + start イベント
* `SpeechSynthesis`
    + voiceschanged イベント (en-US)
* `SpeechSynthesisUtterance`
    + boundary イベント
    + end イベント
    + error イベント
    + mark イベント
    + pause イベント
    + resume イベント
    + start イベント
* `SVGAnimationElement` (en-US)
    + beginEvent イベント (en-US)
    + endEvent イベント (en-US)
    + repeatEvent イベント (en-US)
* `SVGElement`
    + abort イベント
    + error イベント (en-US)
    + load イベント (en-US)
    + resize イベント
    + scroll イベント
    + unload イベント
* `SVGGraphicsElement`
    + copy イベント (en-US)
    + cut イベント (en-US)
    + paste イベント (en-US)
* `TextTrack`
    + cuechange イベント
* `TextTrackList` (en-US)
    + addtrack イベント (en-US)
    + change イベント (en-US)
    + removeTrack イベント (en-US)
* `VideoTrackList`
    + addtrack イベント
    + change イベント
    + removetrack イベント
* `VisualViewport` (en-US)
    + resize イベント (en-US)
    + scroll イベント (en-US)
* `WebSocket`
    + close イベント
    + error イベント
    + message イベント
    + open イベント
* `Window`
    + afterprint イベント
    + animationcancel イベント
    + animationend イベント
    + animationiteration イベント
    + animationstart イベント
    + appinstalled イベント
    + beforeprint イベント
    + beforeunload イベント
    + blur イベント
    + copy イベント
    + cut イベント
    + devicemotion イベント
    + deviceorientation イベント
    + DOMContentLoaded イベント
    + error イベント
    + focus イベント
    + gamepadconnected イベント
    + gamepaddisconnected イベント
    + hashchange イベント
    + languagechange イベント
    + load イベント
    + messageerror イベント
    + message イベント
    + offline イベント
    + online イベント
    + orientationchange イベント
    + pagehide イベント
    + pageshow イベント
    + paste イベント
    + popstate イベント
    + rejectionhandled イベント
    + resize イベント
    + storage イベント
    + transitioncancel イベント
    + transitionend イベント
    + transitionrun イベント
    + transitionstart イベント
    + unhandledrejection イベント
    + unload イベント
    + vrdisplayactivate イベント
    + vrdisplayblur イベント
    + vrdisplayconnect イベント
    + vrdisplaydeactivate イベント
    + vrdisplaydisconnect イベント
    + vrdisplayfocus イベント
    + vrdisplaypointerrestricted イベント
    + vrdisplaypointerunrestricted イベント
    + vrdisplaypresentchange イベント
* `Worker`
    + messageerror イベント
    + message イベント
* `WorkerGlobalScope`
    + languagechange イベント
* `XMLHttpRequest`
    + abort イベント
    + error イベント
    + loadend イベント
    + loadstart イベント
    + load イベント
    + progress イベント
    + timeout イベント
* `XRReferenceSpace`
    + reset イベント
* `XRSession` (en-US)
    + end イベント (en-US)
    + inputsourceschange イベント (en-US)
    + selectend イベント (en-US)
    + selectstart イベント (en-US)
    + select イベント (en-US)
    + squeezeend イベント (en-US)
    + squeezestart イベント (en-US)
    + squeeze イベント (en-US)
    + visibilitychange イベント (en-US)
* `XRSystem`
    + devicechange イベント (en-US)
仕様書
---

| Specification |
| --- |
| HTML Standard # events-2 |