事件處理三代演進
- HTML 事件屬性(DOM Level 0):`
- DOM Level 2 `addEventListener`:`el.addEventListener('click', fn)` — 標準、多監聽器、捕獲/冒泡控制、**現代標準**
- 框架聲明式綁定:React `onClick`、Vue `@click`、Svelte `on:click` — 編譯時轉換為 addEventListener,提供合成事件、自動清理
HTML 事件屬性完整分類表(歷史參考)
窗口/文檔級事件(僅 ``、`
| 屬性 | 觸發時機 | 現代等效 |
| `onload` | 文檔/資源加載完成 | `window.addEventListener('load')`、`DOMContentLoaded` |
| `onunload` | 文檔卸載(關閉/跳轉) | `window.addEventListener('unload')`、`beforeunload` |
| `onbeforeunload` | 離開前確認 | `window.addEventListener('beforeunload')` |
| `onresize` | 視口大小變化 | `window.addEventListener('resize')` |
| `onscroll` | 文檔/元素滾動 | `element.addEventListener('scroll')` |
| `onerror` | 資源加載錯誤/腳本錯誤 | `window.addEventListener('error')`、`unhandledrejection` |
| `onhashchange` | URL hash 變化 | `window.addEventListener('hashchange')` |
| `onpopstate` | 歷史棧變化 | `window.addEventListener('popstate')` |
| `ononline`/`onoffline` | 網絡狀態變化 | `window.addEventListener('online'/'offline')` |
| `onpagehide`/`onpageshow` | 頁面顯示/隱藏(bfcache) | `window.addEventListener('pagehide'/'pageshow')` |
表單控件事件
| 屬性 | 觸發時機 | 適用元素 | 現代等效 |
| `onchange` | 值提交時改變(失去焦點/選擇完成) | `input`、`select`、`textarea` | `change` 事件 |
| `oninput` | 值即時改變(每次輸入) | `input`、`textarea`、`select`、`contenteditable` | `input` 事件(推薦) |
| `onsubmit` | 表單提交 | `form` | `form.addEventListener('submit')` |
| `onreset` | 表單重置 | `form` | `form.addEventListener('reset')` |
| `onselect` | 文本被選中 | `input`、`textarea` | `select` 事件 |
| `onfocus`/`onblur` | 獲得/失去焦點 | 所有可聚焦元素 | `focus`/`blur`(不冒泡)、`focusin`/`focusout`(冒泡) |
| `oninvalid` | 驗證失敗提交時 | 表單控件 | `invalid` 事件 |
| `onformdata` | 構建 FormData 時 | `form` | `formdata` 事件 |
鍵盤事件
| 屬性 | 觸發時機 | 現代等效 | 關鍵屬性 |
| `onkeydown` | 按鍵按下(持續觸發) | `keydown` | `key`、`code`、`ctrlKey`、`shiftKey`、`altKey`、`metaKey`、`repeat`、`isComposing` |
| `onkeypress` | 字符輸入(**已廢棄**) | ❌ 改用 `beforeinput`/`input` | — |
| `onkeyup` | 按鍵釋放 | `keyup` | 同 keydown |
鼠標/指針事件
| 屬性 | 觸發時機 | 現代等效 | 關鍵屬性 |
| `onclick` | 單擊(mousedown+mouseup 同元素) | `click` | `clientX/Y`、`pageX/Y`、`screenX/Y`、`offsetX/Y`、`button`、`buttons`、`target`、`currentTarget` |
| `ondblclick` | 雙擊 | `dblclick` | — |
| `onmousedown` | 按鈕按下 | `mousedown` | — |
| `onmouseup` | 按鈕釋放 | `mouseup` | — |
| `onmousemove` | 指針移動 | `mousemove` | — |
| `onmouseover` | 指針進入元素(冒泡) | `mouseover` | `relatedTarget` |
| `onmouseout` | 指針離開元素(冒泡) | `mouseout` | `relatedTarget` |
| `onmouseenter` | 指針進入元素(**不冒泡**) | `mouseenter` | 配合 `mouseleave` 避免子元素觸發 |
| `onmouseleave` | 指針離開元素(**不冒泡**) | `mouseleave` | — |
| `oncontextmenu` | 右鍵菜單 | `contextmenu` | 預防默認自定義菜單 |
| `onwheel` | 滾輪滾動 | `wheel` | `deltaX/Y/Z`、`deltaMode` |
觸控/指針統一事件
| 事件 | 說明 |
| `pointerdown/up/move/over/out/enter/leave/cancel` | 統一鼠標/觸控/觸控筆,推薦新項目使用 |
| `touchstart/end/move/cancel` | 純觸控,legacy 支持 |
| `gotpointercapture`/`lostpointercapture` | 指針捕獲 |
剪貼板/拖拽/選區/媒體/動畫/其他
- 剪貼板:`oncopy`/`oncut`/`onpaste` → `clipboardData` API
- 拖拽:`ondrag`/`ondragstart`/`ondragend`/`ondragenter`/`ondragover`/`ondragleave`/`ondrop` → `DataTransfer` API
- 選區:`onselectstart`/`onselectionchange` → `Selection` API
- 媒體:`onplay`/`onpause`/`onended`/`ontimeupdate`/`onwaiting`/`oncanplay`/`onloadeddata` 等 → Media Events
- 動畫:`onanimationstart/end/iteration`、`ontransitionend`/`ontransitionrun`/`ontransitionstart`/`ontransitioncancel`
- 全屏:`onfullscreenchange`/`onfullscreenerror`
- 設備:`ondeviceorientation`/`ondevicemotion`/`onorientationchange`
現代事件模型核心機制
事件流三階段
捕獲階段 → 目標階段 → 冒泡階段
el.addEventListener(type, handler, { capture: true }) // 捕獲階段攔截
el.addEventListener(type, handler) // 冒泡階段(默認)
事件對象核心屬性/方法
event.type // 事件類型
event.target // 觸發事件的最深層元素
event.currentTarget // 當前監聽器綁定的元素 (=== this)
event.eventPhase // 1=捕獲 2=目標 3=冒泡
event.bubbles // 是否冒泡
event.cancelable // 是否可取消默認行為
event.preventDefault() // 取消默認行為
event.stopPropagation() // 停止冒泡
event.stopImmediatePropagation() // 停止冒泡並阻止同元素其他監聽器
event.isTrusted // 是否用戶真實觸發(非腳本派發)
event.timeStamp // 高精度時間戳
event.composed // 是否穿透 Shadow DOM
被動事件監聽器(性能關鍵)
// 滾動/觸控監聽器標記 passive: true,瀏覽器可立即滾動不等待 preventDefault
el.addEventListener('touchstart', handler, { passive: true });
el.addEventListener('wheel', handler, { passive: true });
// 需要 preventDefault 時不可用 passive,或用 touch-action: none (CSS)
一次性監聽器
el.addEventListener('click', handler, { once: true }); // 執行後自動移除
AbortController 統一取消
const controller = new AbortController();
el.addEventListener('click', handler, { signal: controller.signal });
controller.abort(); // 批量移除
最佳實踐清單
- **零內聯事件屬性**:CSP `script-src 'self'` 禁止內聯腳本
- **事件委託**:父元素監聽,`event.target.matches(selector)` 過濾,減少綁定、動態元素自動生效
- **被動監聽器**:所有滾動/觸控/輪子事件加 `{passive:true}`
- **合成事件 vs 原生**:框架合成事件池化/歸一化,異步回調中訪問 `event.nativeEvent` 獲取原生對象
- **自定義事件**:`new CustomEvent('my-event', { detail: data, bubbles: true, composed: true })` 穿透 Shadow DOM
- **TypeScript**:`Event`、`MouseEvent`、`KeyboardEvent`、`PointerEvent`、`TouchEvent`、`DragEvent`、`InputEvent`、`FocusEvent`、`SubmitEvent`、`FormDataEvent` 等精確類型
總結
HTML 事件屬性是歷史遺留,現代開發完全基於 `addEventListener` / 框架聲明式綁定。掌握事件流三階段、事件對象、被動監聽器、委託模式、AbortController、自定義事件、TypeScript 類型,是構建健壯、高性能、可維護交互系統的核心技能。