引数の種類 | 説明 |
---|---|
type | 対象とするイベントの種類を表す文字列 |
listener | 指定された型のイベントが発生するときに通知 (Event インターフェースを実装しているオブジェクト) を受け取るオブジェクト。これは、 EventListener インタフェースを実装するオブジェクト、あるいは、単純に、JavaScript の関数でなければなりません。コールバックについて詳しくは、イベントリスナーのコールバックを参照してください。 |
options Optional |
対象のイベントリスナーの特性を指定するオプション。captureBoolean値で、「true」を指定した場合、この型のイベントがDOMツリーで下に位置する「EventTarget」に配信される前に、 登録された「listener」に配信されることを示す。 onceBoolean 値で、「true」を指定した場合、「listener」 の呼び出しを一回のみのとする。 「listener」は一度実行された時に自動的に削除される。 passiveBoolean値で、「true」を指定した場合、「listener」で指定された関数が、「preventDefault()」を呼び出さない。 呼び出されたリスナーが「preventDefault()」を呼び出すと、 自動的にコンソールに警告を出力する。 mozSystemGroupBoolean値で、「true」を指定した場合、リスナーをシステムグループに追加する。 コードが「XBL」「chrome」 で実行されている場合のみ利用可能。 |
useCapture Optional |
Boolean値で、「true」を指定した場合、 この型のイベントがDOMツリーで下に位置する「EventTarget」に配信される前に、 登録された「listener」に配信されることを示す。 上方向にバブリングしているイベントは、キャプチャーを使用するように指定されたリスナーを起動しない。 デフォルトは、「false」。 |
wantsUntrusted |
Boolean値で、「true」の場合、 ウェブコンテンツによって発火された合成イベント (カスタムイベント) を受け取る。 ブラウザーのクロームのデフォルトは「false」。 一般のウェブページのデフォルトは「true」。 この引数は Gecko でのみ利用可能。 |
イベント名 | 説明 |
---|---|
error | リソースをロードできなかったとき。 |
abort | リソースの読み込みが中止されたとき。 |
load | リソースとそれに依存するリソースのロードが完了したとき。 |
beforeunload | ウィンドウ、文書、およびそのリソースがアンロードされる前。 |
unload | 文書または依存するリソースがアンロードされたとき。 |
ネットワークイベント | |
online | ブラウザーがネットワークにアクセスしたとき。 |
offline | ブラウザーがネットワークにアクセスできなかったとき。 |
フォーカスイベント | |
focus | 要素がフォーカスされているとき (バブリングなし)。 |
blur | 要素がフォーカスを失ったとき (バブリングなし)。 |
focusin | 要素がフォーカスされようとしているとき (バブリングあり)。 |
focusout | 要素がフォーカスを失いかけているとき (バブリングあり)。 |
WebSocket イベント | |
open | WebSocket 接続が確立されたとき。 |
message | WebSocket 経由でメッセージを受信したとき。 |
error | WebSocket の接続が障害(例えば、データの一部を送信できなかったなど)により終了したとき。 |
close | WebSocket 接続が閉じられたとき。 |
セッション履歴イベント | |
pagehide | セッション履歴のエントリが横断されているとき。 |
pageshow | セッション履歴のエントリが移動されているとき。 |
popstate | セッション履歴エントリが(場合によっては)ナビゲートされているとき。 |
CSS アニメーションイベント | |
animationstart | CSS アニメーションが開始したとき。 |
animationend | CSS アニメーションが終了したとき。 |
animationiteration | CSS アニメーションが繰り返されたとき。 |
CSS トランジションイベント | |
transitionstart | CSS トランジションが実際に始まったとき。(発火までに遅延がある) |
transitioncancel | CSS トランジションがキャンセルされたとき。 |
transitionend | CSS トランジションが終了したとき。 |
transitionrun | CSS トランジションが実行し始めたとき。(遅延が始まる前に発火する) |
フォームイベント | |
reset | リセットボタンが押されたとき。 |
submit | サブミットボタンが押されたとき。 |
プリントイベント | |
beforeprint | プリントダイアログを開いたとき。 |
afterprint | プリントダイアログを閉じたとき。 |
文章構成イベント | |
compositionstart | 文章作成の準備がされたとき(キーボード入力のキーダウンに似ていますが、音声認識などの他の入力でも動作します)。 |
compositionupdate | 作成中の文章に文字が追加されたとき。 |
compositionend | 文章作成が終了したり、キャンセルされたとき。 |
ビューイベント | |
fullscreenchange | 要素がフルスクリーンモードに切り替えられたとき。 |
fullscreenerror | 技術的な理由か許可が下りなかったため、フルスクリーンモードに切り替えることができないとき。 |
resize | ドキュメントビューのサイズが変更されたとき。 |
scroll | 画面がスクロールされたとき。 |
クリップボードイベント | |
cut | 選択範囲が切り取られてクリップボードにコピーされたとき。 |
copy | 選択範囲がクリップボードにコピーされたとき。 |
paste | クリップボードからアイテムが貼り付けられたとき。 |
キーボードイベント | |
keydown | 任意のキーが押されたとき。 |
keypress | Shift、Fn、CapsLock を除く任意のキーが押された状態にあるとき (連続して発生する)。 |
keyup | 任意のキーが (押された状態から) 解放されるとき。 |
マウスイベント | |
auxclick | ポインティングデバイスのボタン(主ボタン以外のボタン)が、要素上で押し離されたとき。 |
click | ポインティングデバイスのボタン(任意のボタン。まもなく主ボタンのみになります)が、要素上で押し離されたとき。 |
contextmenu | マウスの右ボタンがクリックされたとき(コンテキストメニューが表示される前)。 |
dblclick | ポインティングデバイスのボタンが、要素上でダブルクリックされたとき。 |
mousedown | ポインティングデバイスのボタンが、要素上で押されているとき。 |
mouseenter | ポインティングデバイスが、リスナーが接続されている要素に移動したとき。 |
mouseleave | ポインティングデバイスが、リスナーが接続されている要素から外れたとき。 |
mousemove | ポインティングデバイスが、要素上を移動しているとき(マウスの移動に合わせて連続発火します)。 |
mouseover | ポインティングデバイスが、リスナーが接続されている要素、またはその子要素に移動したとき。 |
mouseout | ポインティングデバイスが、リスナーが接続されている要素、またはその子要素から外れたとき。 |
mouseup | ポインティングデバイスのボタンが、要素上で離されたとき。 |
pointerlockchange | ポインターがロックされたか解除されたとき。 |
pointerlockerror | ポインターのロックが、技術的な理由か動作を拒否されたためにできないとき。 |
select | テキストが選択されているとき。 |
wheel | ポインティングデバイスのホイールボタンが、任意の方向に回転しているとき。 |
ドラッグ & ドロップイベント | |
drag | 要素もしくは選択文字列がドラッグされている間。(350 ミリ秒ごとに断続的に発火します) |
dragend | ドラッグ操作が終わったとき。(マウスボタンが放された時、または ESC キーが押されたとき) |
dragenter | 要素もしくは選択文字列がドラッグされて、有効なドロップ対象に入ったとき。 |
dragstart | ユーザーが、要素もしくは選択文字列をドラッグし始めたとき。 |
dragleave | 要素もしくは選択文字列がドラッグされて、有効なドロップ対象からはずれたとき。 |
dragover | 要素もしくは選択文字列が、有効なドロップ対象の上をドラッグされている間。(350 ミリ秒ごとに断続的に発火し |
ます) | |
drop | 要素が有効なドロップ対象にドロップされたとき。(訳注:原文に「選択文字列」の記述がない) |
メディアイベント | |
audioprocess | The input buffer of a ScriptProcessorNode is ready to be processed. |
canplay | The browser can play the media, but estimates that not enough data has been loaded to |
play the media up to its end without having to stop for further buffering of content. | |
canplaythrough | The browser estimates it can play the media up to its end without stopping for content buffering. |
complete | The rendering of an OfflineAudioContext is terminated. |
durationchange | The duration attribute has been updated. |
emptied | The media has become empty; 例えば、this event is sent if the media has already been |
loaded (or partially loaded), and the load() method is called to reload it. | |
ended | Playback has stopped because the end of the media was reached. |
loadeddata | The first frame of the media has finished loading. |
loadedmetadata | The metadata has been loaded. |
pause | Playback has been paused. |
play | Playback has begun. |
playing | Playback is ready to start after having been paused or delayed due to lack of data. |
ratechange | The playback rate has changed. |
seeked | A seek operation completed. |
seeking | A seek operation began. |
stalled | The user agent is trying to fetch media data, but data is unexpectedly not forthcoming. |
suspend | Media data loading has been suspended. |
timeupdate | The time indicated by the currentTime attribute has been updated. |
volumechange | The volume has changed. |
waiting | Playback has stopped because of a temporary lack of data. |
Progress イベント | |
abort | Progression has been terminated (not due to an error). |
error | Progression has failed. |
load | Progression has been successful. |
loadend | Progress has stopped (after "error", "abort" or "load" have been dispatched). |
loadstart | Progress has begun. |
progress | In progress. |
timeout | Progression is terminated due to preset time expiring. |
ストレージイベント | |
change (see Non-standard events) | |
storage | |
更新イベント | |
checking | |
downloading | |
error | |
noupdate | |
obsolete | |
updateready | |
値変更イベント | |
broadcast | |
CheckboxStateChange | |
hashchange | |
input | |
RadioStateChange | |
readystatechange | |
ValueChange | |
未分類のイベント | |
invalid | |
localized | |
message | |
open | |
show |