イベントハンドラ属性名とその説明を種類別に一覧表示しています。目次から各イベント種類の一覧へのジャンプができ、また検索ボックスへの属性名入力による絞り込み表示もできます。
目次
イベントとは
「イベントとは」を参照してください。
イベントハンドラとは
「イベントハンドラとは」を参照してください。
HTMLイベントハンドラ属性(種類別)
注意
イベントハンドラ属性はなるべく利用せず、JavaScriptのAPIで実現するようにしたほうがよいでしょう。理由は次の2点です。①HTMLファイルの肥大化を防止する、②コンテンツを定義する部分と処理を定義する部分で記述を分割できる。
イベントハンドラ属性はなるべく利用せず、JavaScriptのAPIで実現するようにしたほうがよいでしょう。理由は次の2点です。①HTMLファイルの肥大化を防止する、②コンテンツを定義する部分と処理を定義する部分で記述を分割できる。
下の検索ボックスで属性名による絞り込み検索ができます。
該当する属性が見つかりません。
ウィンドウイベント
ブラウザのボタンが押された、ページ遷移したなど、ウィンドウの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
onafterprint | <body> | 印刷ダイアログから印刷実行もしくはキャンセルされた時に実行したいスクリプトを定義する属性です。 |
onbeforeprint | <body> | 印刷ダイアログ表示直前に実行したいスクリプトを定義する属性です。 |
onbeforeunload | <body> | ページ遷移直前、もしくはページを閉じる直前に実行したいスクリプトを定義する属性です。 |
onblur | <body> | ページからフォーカスが外れた時に実行したいスクリプトを定義する属性です。 |
onclose | <dialog> | <dialog>のダイアログが閉じられた時に実行したいスクリプトを定義する属性です。 |
onfocus | <body> | ページにフォーカスが当たった時に実行したいスクリプトを定義する属性です。 |
onhashchange | <body> | 現在のURLのハッシュ(「#」以降)に変更があった時に実行したいスクリプトを定義する属性です。 |
onlanguagechange | <body> | 優先言語が変更された時に実行したいスクリプトを定義する属性です。 |
onload | <body> | ページの読み込みが終了した直後に実行したいスクリプトを定義する属性です。 |
onmessage | <body> | WebSocket、WebRTC、等からのメッセージを受け取った直後に実行したいスクリプトを定義する属性です。 |
onmessageerror | <body> | WebSocket、WebRTC、等からのメッセージ受信に失敗した直後に実行したいスクリプトを定義する属性です。 |
onoffline | <body> | ネットワーク接続に失敗し、ブラウザがオフラインモードになった時に実行したいスクリプトを定義する属性です。 |
ononline | <body> | ネットワーク接続が回復し、ブラウザがオンラインモードからオフラインモードに切り替わった時に実行したいスクリプトを定義する属性です。 |
onpagehide | <body> | 他のページへ移動した時に実行したいスクリプトを定義する属性です。 |
onpageshow | <body> | ページが表示された時に実行したいスクリプトを定義する属性です。 |
onpopstate | <body> | ウィンドウの履歴が変更された時に実行したいスクリプトを定義する属性です。 |
onresize | <body> | 表示領域サイズが変更された時に実行したいスクリプトを定義する属性です。 |
onscroll | <body> | ページがスクロールされた時に実行したいスクリプトを定義する属性です。 |
onstorage | <body> | ストレージエリア (localStorage、sessionStorage) が変更された時に実行したいスクリプトを定義する属性です。 |
onunhandledrejection | <body> | JavaScriptのPromiseオブジェクト処理されなくなった時に実行したいスクリプトを定義する属性です。 |
onunload | <body> | ページを離脱もしくはリロードした時に実行したいスクリプトを定義する属性です。 |
フォームイベント
フォームにテキストが入力された、フォーカスが当たったなど、ブラウザ上のフォームの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
onblur | <body>以外 | 対象要素からフォーカスが外れた時に実行したいスクリプトを定義する属性です。 |
onchange | すべての要素 | 対象要素の値の変更が確定した時に実行したいスクリプトを定義する属性です。 |
onfocus | <body>以外 | 対象要素にフォーカスが当たった時に実行したいスクリプトを定義する属性です。 |
oninput | <input>、<textarea> | 対象要素に値が入力された時に実行したいスクリプトを定義する属性です。 |
oninvalid | <input>、<textarea> | 対象要素に無効な値が入力された状態で送信に失敗した時に実行したいスクリプトを定義する属性です。 |
onreset | <form> | フォーム内容が初期化された時に実行したいスクリプトを定義する属性です。 |
onselect | <input>、<textarea> | 対象要素のテキストが選択された時に実行したいスクリプトを定義する属性です。 |
onsubmit | <form> | フォーム内容が送信された時に実行したいスクリプトを定義する属性です。 |
キーボードイベント
キーボードのキーを押した時、つまりキーボードの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
onkeydown | すべての要素 | 任意のキーが押され続けている時に実行したいスクリプトを定義する属性です。 |
onkeypress | すべての要素 | 任意のキーが押された時に実行したいスクリプトを定義する属性です。 |
onkeyup | すべての要素 | 任意のキーが離された時に実行したいスクリプトを定義する属性です。 |
マウスイベント
マウスのボタンを押す、ドラッグするなど、マウスの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
onauxclick | すべての要素 | マウスの中央ボタンが押された時に実行したいスクリプトを定義する属性です。 |
onclick | すべての要素 | 対象要素がクリックされた時に実行したいスクリプトを定義する属性です。 |
oncontextmenu | すべての要素 | 対象要素が右クリックされた時に実行したいスクリプトを定義する属性です。 |
ondblclick | すべての要素 | 対象要素がダブルクリックされた時に実行したいスクリプトを定義する属性です。 |
ondrag | すべての要素 | ドラッグ操作が行われている時に実行したいスクリプトを定義する属性です。 |
ondragend | すべての要素 | ドラッグ操作が終了した時に実行したいスクリプトを定義する属性です。 |
ondragenter | すべての要素 | ドラッグ操作中にマウスポインタが対象要素に乗った時に実行したいスクリプトを定義する属性です。 |
ondragexit | すべての要素 | ドラッグ操作時に対象要素が操作対象ではなくなった時に実行したいスクリプトを定義する属性です。 |
ondragleave | すべての要素 | ドラッグ操作中にマウスポインタが対象要素から離れた時に実行したいスクリプトを定義する属性です。 |
ondragover | すべての要素 | ドラッグ操作中にマウスポインタが対象要素の上で動いた時に実行したいスクリプトを定義する属性です。 |
ondragstart | すべての要素 | ドラッグ操作が開始された時に実行したいスクリプトを定義する属性です。 |
ondrop | すべての要素 | ドロップ操作された時に実行したいスクリプトを定義する属性です。 |
onmousedown | すべての要素 | マウスボタンが押された時に実行したいスクリプトを定義する属性です。 |
onmouseenter | すべての要素 | マウスポインタが対象要素に重なった直後に実行したいスクリプトを定義する属性です。 |
onmouseleave | すべての要素 | マウスポインタが対象要素から離れた直後に実行したいスクリプトを定義する属性です。 |
onmousemove | すべての要素 | マウスポインタが対象要素上を移動した時に実行したいスクリプトを定義する属性です。 |
onmouseout | すべての要素 | マウスポインタが対象要素から離れた直後に実行したいスクリプトを定義する属性です。 |
onmouseover | すべての要素 | マウスポインタが対象要素から離れる直前に実行したいスクリプトを定義する属性です。 |
onmouseup | すべての要素 | マウスボタンが離された時に実行したいスクリプトを定義する属性です。 |
onscroll | <body>以外 | 対象要素がスクロールされた時に実行したいスクリプトを定義する属性です。 |
onwheel | すべての要素 | マウスのホイールが回された時に実行したいスクリプトを定義する属性です。 |
クリップボードイベント
クリップボードの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
oncopy | すべての要素 | ユーザが対象要素のデータをコピーした時に実行したいスクリプトを定義する属性です。 |
oncut | すべての要素 | ユーザが対象要素のデータを切り取りした時に実行したいスクリプトを定義する属性です。 |
onpaste | すべての要素 | ユーザが対象要素にデータを貼り付けされた時に時に実行したいスクリプトを定義する属性です。 |
メディアイベント
メディアが再生開始する、音量が上がるなど、メディアの状態に変化があった場合に発生するイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
oncanplay | すべての要素 | メディアリソースが再生可能となった時に実行したいスクリプトを定義する属性です。 |
oncanplaythrough | すべての要素 | メディアリソースが再生途中でバッファリングせず最後まで再生可能となった時に実行したいスクリプトを定義する属性です。 |
oncuechange | <track> | 外部テキストリソース(字幕など)が更新された時に実行したいスクリプトを定義する属性です。 |
ondurationchange | すべての要素 | メディアリソースの長さ(duration属性の値)が更新された時に実行したいスクリプトを定義する属性です。 |
onended | すべての要素 | メディアリソースが最後まで再生され終了した時に実行したいスクリプトを定義する属性です。 |
onloadeddata | すべての要素 | メディアリソースの最初のフレームの読み込みが完了した時に実行したいスクリプトを定義する属性です。 |
onloadedmetadata | すべての要素 | メディアリソースのメタデータの読み込みが完了した時に実行したいスクリプトを定義する属性です。 |
onloadend | すべての要素 | メディアリソースの読み込みが終了した時に実行したいスクリプトを定義する属性です。 |
onloadstart | すべての要素 | メディアリソースの読み込みが開始した時に実行したいスクリプトを定義する属性です。 |
onpause | すべての要素 | メディアプレイヤーが一時停止した時に実行したいスクリプトを定義する属性です。 |
onplay | すべての要素 | メディアプレイヤーが再生開始した時に実行したいスクリプトを定義する属性です。 |
onplaying | すべての要素 | メディアプレイヤーが一時停止から再生再開、もしくは再生終了後に再生開始した時に実行したいスクリプトを定義する属性です。 |
onprogress | <img> | メディアリソースのバッファリング進捗値が更新された時に実行したいスクリプトを定義する属性です。 |
onratechange | すべての要素 | メディアプレイヤーの再生速度(defaultPlaybackRate属性、playbackRate属性の値)が変更された時に実行したいスクリプトを定義する属性です。 |
onseeked | すべての要素 | メディアプレイヤーのシーク操作が完了した時に実行したいスクリプトを定義する属性です。 |
onseeking | すべての要素 | メディアプレイヤーのシーク操作を開始した時に実行したいスクリプトを定義する属性です。 |
onstalled | すべての要素 | メディアリソースが全く読み込めなかった時に実行したいスクリプトを定義する属性です。 |
onsuspend | すべての要素 | メディアリソースの読み込みが中断された時に実行したいスクリプトを定義する属性です。 |
ontimeupdate | すべての要素 | メディアプレイヤーの再生時刻が更新された時に実行したいスクリプトを定義する属性です。 |
onvolumechange | すべての要素 | メディアプレイヤーの音量(volume属性、muted属性の値)が変更された時に実行したいスクリプトを定義する属性です。 |
onwaiting | すべての要素 | メディアプレイヤーへの要求された操作が別操作の完了待ちの間に遅延が発生した時に実行したいスクリプトを定義する属性です。 |
その他イベント
上記以外のイベントです。
属性名 | 対象要素 | 属性の説明 |
---|---|---|
onabort | すべての要素 | ユーザによって処理が中断された時に実行したいスクリプトを定義する属性です。 |
oncancel | <dialog> | <dialog>のダイアログがユーザによってキャンセルされた時に実行したいスクリプトを定義する属性です。 |
onclose | <dialog>以外 | WebSocketの接続が終了した時に実行したいスクリプトを定義する属性です。 |
onerror | すべての要素 | 予期しないエラー(ネットワークエラー、スクリプトエラーなど)が発生した時に実行したいスクリプトを定義する属性です。 |
onload | <body>以外 | 対象リソースの読み込みが終了した直後に実行したいスクリプトを定義する属性です。 |
onresize | <body>以外 | 対象要素のサイズが変更された時に実行したいスクリプトを定義する属性です。 |
onsecuritypolicyviolation | すべての要素 | 対象要素でコンテンツセキュリティポリシー違反が生成された時に実行したいスクリプトを定義する属性です。 |
onshow | すべての要素 | コンテキストメニューが表示された時に実行したいスクリプトを定義する属性です。 |
ontoggle | <details> | <details>要素のアコーディオンメニューの表示・非表示が切り替わった時に実行したいスクリプトを定義する属性です。 |