HTML5 統一了事件屬性命名,並新增多項媒體、視窗狀態等事件。本文分類彙整所有可用於 HTML 元素 on* 屬性的事件,方便快速查閱。
視窗事件(適用 <body>)
| 屬性 | 觸發時機 |
onload | 文檔載入完成 |
onunload | 使用者離開文檔 |
onbeforeunload | 文檔即將卸載(可攔截) |
onresize | 視窗大小改變 |
onscroll | 文檔/元素捲動 |
onerror | 資源載入錯誤或腳本錯誤 |
ononline / onoffline | 網路上線/離線 |
onhashchange | URL 雜湊值改變 |
onpopstate | 歷史記錄變更 |
onpageshow / onpagehide | 頁面顯示/隱藏(bfcache 相關) |
onmessage | 收到 postMessage |
onstorage | localStorage/sessionStorage 變更 |
表單事件(適用表單元素)
| 屬性 | 觸發時機 |
onchange | 值改變並失去焦點 |
oninput | 值即時改變(HTML5 新增) |
oninvalid | 驗證失敗 |
onsubmit | 表單送出 |
onreset | 表單重置 |
onfocus / onblur | 獲得/失去焦點 |
onselect | 文字被選取 |
onformchange / onforminput | 表單狀態/輸入變更(已棄用) |
鍵盤事件(適用所有元素)
| 屬性 | 觸發時機 |
onkeydown | 按鍵按下 |
onkeypress | 字元輸入(已棄用,改用 beforeinput/input) |
onkeyup | 按鍵釋放 |
滑鼠/指標事件(適用所有元素)
| 屬性 | 觸發時機 |
onclick | 單擊 |
ondblclick | 雙擊 |
onmousedown / onmouseup | 按下/釋放按鈕 |
onmousemove | 指標移動 |
onmouseover / onmouseout | 進入/離開元素(冒泡) |
onmouseenter / onmouseleave | 進入/離開元素(不冒泡) |
onwheel | 滾輪滾動(標準化) |
oncontextmenu | 右鍵選單 |
ondrag* 系列 | 拖放相關(見 Drag & Drop 專文) |
媒體事件(適用 <audio>、<video>、<img> 等)
| 屬性 | 觸發時機 |
oncanplay | 可開始播放(可能需緩衝) |
oncanplaythrough | 可完整播放無需緩衝 |
onplay / onpause | 播放/暫停 |
onended | 播放結束 |
ontimeupdate | 播放位置更新 |
onvolumechange | 音量變更 |
onloadeddata / onloadedmetadata | 媒體資料/中繼資料載入完成 |
onerror | 媒體載入錯誤 |
onwaiting / onplaying | 等待緩衝/恢復播放 |
onseeked / onseeking | 搜尋完成/進行中 |
最佳實務建議
- 優先使用
addEventListener 而非內聯 on* 屬性,利於關注點分離、多監聽器、移除監聽。
- 事件物件統一為第一參數
event,避免使用 window.event(IE 專有)。
- 被動事件監聽器
{ passive: true } 可提升捲動/觸控效能。
- 媒體事件較多,建議封裝為自訂 Hook 或狀態機管理播放器邏輯。