HTML 4 には、ユーザが要素をクリックしたとき、JavaScriptがスタートするような、 ブラウザ内でアクションをトリガーできるようにする機能が追加されました。
イベントのプログラミングの詳細については、JavaScript チュートリアルをご覧ください。
下の表は、イベントアクションを定義するために、HTML要素に追加することができるグローバルイベント属性です。
= HTML5で追加されたイベント属性。
windowオブジェクトにトリガされるイベント(<body>タグに適用されます):
| 属性 | 値 | 説明 |
|---|---|---|
| onafterprint | script | 文書の印刷後に実行するスクリプト |
| onbeforeprint | script | 文書の印刷前に実行するスクリプト |
| onbeforeunload | script | 文書をアンロードする前に実行するスクリプト |
| onerror | script | エラーが発生したときに実行するスクリプト |
| onhashchange | script | URL のアンカー部分に変更があったときに実行するスクリプト。 |
| onload | script | ページのロードが終了した後で開始 |
| onmessage | script | メッセージがトリガされたときに実行するスクリプト |
| onoffline | script | ブラウザがオフラインで動作を開始したときに実行するスクリプト。 |
| ononline | script | ブラウザがオンラインで動作を開始したときに実行するスクリプト。 |
| onpagehide | script | ユーザがページから移動するときに実行するスクリプト。 |
| onpageshow | script | ユーザがページに移動したときに実行するスクリプト。 |
| onpopstate | script | ウィンドウの履歴が変わるときに実行するスクリプト |
| onresize | script | ブラウザのウィンドウ・サイズを変更したときに開始 |
| onstorage | script | ウェブ・ストレージ・エリアが更新されたときに実行するスクリプト |
| onunload | script | ページがアンロードしたときに(またはブラウザウィンドウが閉じられたときに)実行するスクリプト。 |
HTML フォーム内のアクションでトリガされるイベント(ほとんど全ての HTML 要素に適用されますが、大抵はフォーム要素で使用します):
| 属性 | 値 | 説明 |
|---|---|---|
| onblur | script | 要素がフォーカスを失った瞬間に始動する |
| onchange | script | 要素の値が変った瞬間に始動する |
| oncontextmenu | script | コンテキストメニューがトリガされたときに実行するスクリプト |
| onfocus | script | 要素がフォーカスを取得した瞬間に始動する |
| oninput | script | 要素がユーザ入力を取得するときに実行するスクリプト |
| oninvalid | script | 要素が無効なときに実行するスクリプト |
| onreset | script | フォームのリセットボタンがクリックされたときに始動する |
| onsearch | script | ユーザが検索フィールドに何かを書き込むときに始動する(<input="search"> の場合) |
| onselect | script | 要素のテキストが選択されたときに始動する |
| onsubmit | script | フォームが送信されたときに始動する |
| 属性 | 値 | 説明 |
|---|---|---|
| onkeydown | script | ユーザがキーを押しているときに始動する |
| onkeypress | script | >ユーザがキーを押したときに始動する |
| onkeyup | script | >ユーザがキーを放したときに始動する |
マウスまたは類似のユーザーアクションによって起動されるイベント::
| 属性 | 値 | 説明 |
|---|---|---|
| onclick | script | 要素がクリックされたときに始動する |
| ondblclick | script | 要素がダブルクリックされたときに始動する |
| ondrag | script | 要素をドラッグしたときに実行するスクリプト |
| ondragend | script | ドラッグ操作の終了時に実行するスクリプト |
| ondragenter | script | 要素が有効なドロップターゲットにドラッグされたときに実行するスクリプト |
| ondragleave | script | 要素が有効なドロップターゲットから離れたときに実行するスクリプト |
| ondragover | script | 要素が有効なドロップターゲット上にドラッグされているときに実行するスクリプト |
| ondragstart | script | ドラッグ操作の開始時に実行するスクリプト |
| ondrop | script | ドラッグされた要素がドロップされているときに実行するスクリプト |
| onmousedown | script | 要素上でマウスボタンが押下されたときに始動する |
| onmousemove | script | マウスポインタが要素上を移動しているときに始動する |
| onmouseout | script | マウスポインタが要素の外に移動したときに始動する |
| onmouseover | script | マウスポインタが要素の上に移動したときに始動する |
| onmouseup | script | マウスボタンを要素上で放したときに始動する |
| onmousewheel | script | 非推奨 代わりに onwheel 属性を使用してください |
| onscroll | script | 要素のスクロールバーがスクロールされているときに実行するスクリプト |
| onwheel | script | 要素の上でマウスホイールをロールアップやロールダウンしたときに始動する |
| 属性 | 値 | 説明 |
|---|---|---|
| oncopy | script | 要素のコンテンツをコピーするときに始動する |
| oncut | script | 要素のコンテンツをカットするときに始動する |
| onpaste | script | ユーザが要素に或るコンテンツを貼り付けるときに始動する |
ビデオ、画像やオーディオなどのメディアによってトリガーされるイベントです(すべての HTML 要素に適用されますが、 <audio>、<embed>、<img>、<object>、や <video>のようなメディア要素に適用するのがが最も一般的です)。
チップ: 詳細は、HTML Audio および Video DOM リファレンス をご覧ください。
| 属性 | 値 | 説明 |
|---|---|---|
| onabort | script | アボート時に実行するスクリプト |
| oncanplay | script | ファイルの再生を開始する準備ができたとき(開始するのに十分なバッファリングをした場合)に実行するスクリプト |
| oncanplaythrough | script | ファイルがバッファリングのために一時停止することなく、最後までずっと再生できるときに実行するスクリプト |
| oncuechange | script | <track> 要素内のキューを変更するときに実行するスクリプト |
| ondurationchange | script | メディアの長さが変化するときに実行するスクリプト |
| onemptied | script | 悪い何かが起こり、ファイルが突然使用できない(予想外の切断など)ようなときに実行するスクリプト |
| onended | script | メディアが終わりに達したときに実行するスクリプト(「聞いてくれてありがとう」のようなメッセージのための役立つイベント) |
| onerror | script | ファイルのロード中に、エラーが発生したときに実行するスクリプト |
| onloadeddata | script | メディアデータが読み込まれたときに実行するスクリプト |
| onloadedmetadata | script | メタデータ(dimensions や duration など)がロードされたときに実行するスクリプト |
| onloadstart | script | 動画または音声の読込処理に入った際に実行するスクリプト |
| onpause | script | メディアがユーザまたはプログラムによって一時停止されたときに実行するスクリプト |
| onplay | script | メディアの再生開始の準備ができたときに実行するスクリプト |
| onplaying | script | メディアの再生が実際に開始したときに実行するスクリプト |
| onprogress | script | ブラウザがメディアデータを取得中であるときに実行するスクリプト |
| onratechange | script | 再生速度の変更(スローモーションとか早送りモードへの切り替えなど)するたびに実行するスクリプト |
| onseeked | script | seeking 属性にシークが終了したことを示す false が設定されたときに実行するスクリプト |
| onseeking | script | seeking 属性にシークがアクティブであることを示す true が設定されているときに実行するスクリプト |
| onstalled | script | ブラウザが何らかの理由でメディアデータをフェッチすることができないときに実行するスクリプト |
| onsuspend | script | 何らかの理由で完全にロードする前にフェッチメディアデータが停止されたときに実行するスクリプト |
| ontimeupdate | script | 再生位置が変更されたときに(メディア内の別のポイントに早送りしたような場合に)実行するスクリプト |
| onvolumechange | script | ボリュームを変更するたびに(ボリュームを "mute" に設定することも含む)実行するスクリプト |
| onwaiting | script | メディアは一時停止したが、再開することになっているとき(メディアが、より多くのデータをバッファリングするために一時停止しているような場合)に 実行するスクリプト |
| 属性 | 値 | 説明 |
|---|---|---|
| onerror | script | エラーが発生したときに始動する |
| onshow | script | <menu> 要素がコンテキストメニューとして表示されたときに始動する |
| ontoggle | script | ユーザが <details> 要素を開閉するときに始動する |