萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 事件屬性完整參考:從內聯處理器到現代事件模型

事件處理三代演進

  1. HTML 事件屬性(DOM Level 0):`
  2. DOM Level 2 `addEventListener`:`el.addEventListener('click', fn)` — 標準、多監聽器、捕獲/冒泡控制、**現代標準**
  3. 框架聲明式綁定: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(); // 批量移除

最佳實踐清單

  1. **零內聯事件屬性**:CSP `script-src 'self'` 禁止內聯腳本
  2. **事件委託**:父元素監聽,`event.target.matches(selector)` 過濾,減少綁定、動態元素自動生效
  3. **被動監聽器**:所有滾動/觸控/輪子事件加 `{passive:true}`
  4. **合成事件 vs 原生**:框架合成事件池化/歸一化,異步回調中訪問 `event.nativeEvent` 獲取原生對象
  5. **自定義事件**:`new CustomEvent('my-event', { detail: data, bubbles: true, composed: true })` 穿透 Shadow DOM
  6. **TypeScript**:`Event`、`MouseEvent`、`KeyboardEvent`、`PointerEvent`、`TouchEvent`、`DragEvent`、`InputEvent`、`FocusEvent`、`SubmitEvent`、`FormDataEvent` 等精確類型

總結

HTML 事件屬性是歷史遺留,現代開發完全基於 `addEventListener` / 框架聲明式綁定。掌握事件流三階段、事件對象、被動監聽器、委託模式、AbortController、自定義事件、TypeScript 類型,是構建健壯、高性能、可維護交互系統的核心技能。

copyright © 萬盛學電腦網 all rights reserved