HTML 元素可以帶有事件屬性,這些屬性會在瀏覽器中觸發對應行為,例如使用者點擊某個元素時執行一段 JavaScript。以下把可用的事件屬性整理成表格,方便插入標籤時快速查閱。
HTML5 新增的事件屬性:
onabort、onbeforeunload、oncontextmenu、ondrag、ondragend、ondragenter、ondragleave、ondragover、ondragstart、ondrop、onerror、onmessage、onmousewheel、onresize、onscroll、onunload。
HTML 4.01 中存在、HTML5 已不再支援的屬性:onreset。
| 屬性 | 值 | 描述 | 4.01 | 5 |
|---|---|---|---|---|
| onabort | script | 發生 abort 事件時執行腳本 | ✓ | |
| onbeforeonload | script | 在元素載入前執行腳本 | ✓ | |
| onblur | script | 元素失去焦點時執行腳本 | ✓ | ✓ |
| onchange | script | 元素內容改變時執行腳本 | ✓ | ✓ |
| onclick | script | 滑鼠點擊時執行腳本 | ✓ | ✓ |
| oncontextmenu | script | 右鍵選單被觸發時執行腳本 | ✓ | |
| ondblclick | script | 滑鼠雙擊時執行腳本 | ✓ | ✓ |
| ondrag | script | 元素正在被拖曳的過程中持續執行腳本 | ✓ | |
| ondragend | script | 拖曳操作結束時執行腳本 | ✓ | |
| ondragenter | script | 被拖曳的元素進入合法放置目標時執行腳本 | ✓ | |
| ondragleave | script | 被拖曳的元素離開合法放置目標時執行腳本 | ✓ | |
| ondragover | script | 元素在合法放置目標上方拖曳時執行腳本 | ✓ | |
| ondragstart | script | 拖曳操作開始時執行腳本 | ✓ | |
| ondrop | script | 元素被放下的瞬間執行腳本 | ✓ | |
| onerror | script | 元素載入過程中發生錯誤時執行腳本 | ✓ | |
| onfocus | script | 元素取得焦點時執行腳本 | ✓ | ✓ |
| onkeydown | script | 按鍵被按下時執行腳本 | ✓ | ✓ |
| onkeypress | script | 按鍵被按下(按壓階段)時執行腳本 | ✓ | ✓ |
| onkeyup | script | 按鍵被放開時執行腳本 | ✓ | ✓ |
| onload | script | 文件載入完成時執行腳本 | ✓ | ✓ |
| onmessage | script | message 事件被觸發時執行腳本 | ✓ | |
| onmousedown | script | 滑鼠按鈕被按下時執行腳本 | ✓ | ✓ |
| onmousemove | script | 滑鼠指標移動時執行腳本 | ✓ | ✓ |
| onmouseover | script | 滑鼠指標移入元素範圍時執行腳本 | ✓ | ✓ |
| onmouseout | script | 滑鼠指標移出元素範圍時執行腳本 | ✓ | ✓ |
| onmouseup | script | 滑鼠按鈕被放開時執行腳本 | ✓ | ✓ |
| onmousewheel | script | 滑鼠滾輪滾動時執行腳本 | ✓ | |
| onreset | script | 表單被重設時執行腳本 | ✓ | 不支援 |
| onresize | script | 元素尺寸改變時執行腳本 | ✓ | |
| onscroll | script | 元素捲軸被捲動時執行腳本 | ✓ | |
| onselect | script | 元素中的文字被選取時執行腳本 | ✓ | ✓ |
| onsubmit | script | 表單被送出時執行腳本 | ✓ | ✓ |
| onunload | script | 文件被卸載時執行腳本 | ✓ |
拖曳系列事件(ondragstart、ondragenter、ondragover、ondragleave、ondrop、ondragend)是 HTML5 才完整成形的一組,通常需要搭配 dataTransfer 物件交換資料,並在 dragover 階段呼叫 preventDefault(),否則 drop 事件不會觸發。
另外,onscroll 與 onresize 觸發頻率極高,實務上幾乎一定要搭配 debounce 或 throttle 處理,避免效能被大量回呼吃掉。而 onerror 除了用於資源載入失敗,也常與全域錯誤處理搭配使用。