HTML5 為元素定義了大量標準事件屬性,這些屬性可以直接寫在標籤上,也可以在腳本中綁定。由於種類繁多,平時查閱並不方便,這裡按五大類別整理成對照表,當成速查手冊使用。
整體可分為五組:視窗事件(Window)、表單事件(Form)、鍵盤事件(Keyboard)、鼠標事件(Mouse)與媒體事件(Media)。
由 window 對象觸發,通常寫在 body 標籤上。
onafterprint:文件列印完成後執行腳本。
onbeforeprint:文件列印前執行腳本。
onbeforeunload:文件即將卸載前執行腳本。
onblur:視窗失去焦點時執行腳本。
onerror:發生錯誤時執行腳本。
onfocus:視窗取得焦點時執行腳本。
onhaschange:文件 URL 的 hash 部分改變時執行腳本。
onload:文件載入完成時執行腳本。
onmessage:收到訊息(例如 postMessage)時執行腳本。
onoffline:文件進入離線狀態時執行腳本。
online:文件恢復連線時執行腳本。
onpagehide:視窗被隱藏時執行腳本。
onpageshow:視窗變為可見時執行腳本。
onpopstate:瀏覽歷史記錄被操作時執行腳本。
onredo:執行重做時執行腳本。
onresize:視窗尺寸改變時執行腳本。
onstorage:Web Storage 區域更新時執行腳本。
onundo:執行復原時執行腳本。
onunload:用戶離開文件時執行腳本。
由表單內部的互動觸發,適用於所有 HTML5 元素,但最常用在表單元件上。
onblur:元素失去焦點。
onchange:元素的值被改變。
oncontextmenu:觸發右鍵選單。
onfocus:元素取得焦點。
onformchange:表單內容改變。
onforminput:表單收到使用者輸入。
oninput:元素收到使用者輸入。
oninvalid:元素驗證未通過。
onreset:表單被重置(HTML5 已不支援此寫法)。
onselect:使用者選取文字。
onsubmit:表單被送出。
由鍵盤操作觸發,適用於所有 HTML5 元素。
onkeydown:按鍵被按下的瞬間。
onkeypress:按鍵被按下並放開(用於可列印字元)。
onkeyup:按鍵被放開。
由鼠標或相似指標裝置觸發,適用於所有 HTML5 元素。其中拖放系列是 HTML5 新增的重點。
onclick:單擊。
ondblclick:雙擊。
ondrag:元素被拖曳過程中持續觸發。
ondragend:拖曳結束。
ondragenter:元素被拖入有效放置區。
ondragleave:元素離開有效放置區。
ondragover:元素被拖到有效放置區上方。
ondragstart:拖曳開始。
ondrop:元素被放下。
onmousedown:鼠標按鈕被按下。
onmousemove:鼠標指標移動。
onmouseout:指標移出元素。
onmouseover:指標移入元素。
onmouseup:鼠標按鈕被放開。
onmousewheel:滾動滾輪。
onscroll:元素捲軸被捲動。
由影片、音訊、圖片等媒體觸發,適用於所有 HTML5 元素,但在 audio、video、embed、img、object 上最常見。這一組是 HTML5 自建播放器的基礎。
onabort:播放被中止。
oncanplay:可以開始播放,但可能因緩取而停頓。
oncanplaythrough:可一路播放到結尾而不需緩衝。
ondurationchange:媒體長度改變。
onemptied:媒體資源突然變為空(網路或載入錯誤)。
onended:播放到結尾。
onerror:載入期間發生錯誤。
onloadeddata:媒體資料已載入。
onloadedmetadata:長度與其他中介資料已載入。
onloadstart:瀏覽器開始載入媒體。
onpause:暫停。
onplay:即將開始播放。
onplaying:已開始播放。
onprogress:瀏覽器正在取得媒體資料。
onratechange:播放速率改變。
onreadystatechange:就緒狀態改變。
onseeked:跳轉結束。
onseeking:跳轉開始。
onstalled:取回資料時發生延遲。
onsuspend:在取完整個檔案前停止載入。
ontimeupdate:播放位置改變。
onvolumechange:音量改變或切換靜音。
onwaiting:停止播放但計畫繼續。
使用上有兩點值得提醒。一是 onmousewheel 屬於非標準擴充,標準做法已改為監聽 wheel 事件;二是 onreset、onformchange 這類標註為「HTML5 不支援」的屬性,僅為歷史相容而保留,新專案中不建議依賴。所有事件屬性的值都是一段 script,直接寫在標籤上雖然方便,但較好的實踐仍是在外部腳本中用 addEventListener 綁定,讓結構與行為分離。