萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

HTML 事件屬性完整分類與現代 addEventListener 最佳實踐

事件屬性分類速查

分類適用元素常見事件
視窗/文件<body>, <frameset>onload, onunload, onbeforeunload, onresize, onscroll, onerror
表單表單控制項onchange, oninput, onsubmit, onreset, onselect, onfocus, onblur, oninvalid
鍵盤除 <base>, <head> 等外多數元素onkeydown, onkeypress, onkeyup
滑鼠除上述外多數元素onclick, ondblclick, onmousedown, onmouseup, onmousemove, onmouseover, onmouseout, onmouseenter, onmouseleave, onwheel, oncontextmenu
觸控/指標觸控裝置支援元素ontouchstart, ontouchmove, ontouchend, onpointerdown, onpointermove, onpointerup, onpointerenter, onpointerleave
剪貼簿可編輯/輸入元素oncopy, oncut, onpaste
拖放所有元素ondragstart, ondrag, ondragend, ondragenter, ondragover, ondragleave, ondrop
媒體<audio>, <video>onplay, onpause, onended, ontimeupdate, onvolumechange, oncanplay, onloadeddata, onerror
動畫/轉場所有元素onanimationstart, onanimationend, onanimationiteration, ontransitionend, ontransitionstart
其他-onfocusin, onfocusout, onscrollend, onbeforetoggle (popover)

為什麼棄用 on* 屬性?

  • 同一事件僅能綁一個處理器,後設定會覆蓋前者。
  • HTML 與 JS 耦合,違反關注點分離。
  • CSP `script-src 'unsafe-inline'` 風險。
  • 無法使用事件捕獲階段、無法 `stopImmediatePropagation` 精細控制。
  • 參數傳遞不靈活 (需用閉包或全域變數)。

現代標準寫法

// 單一元素
btn.addEventListener('click', handleClick, { passive: true, once: false });

// 事件代理 (效能最佳)
document.getElementById('list').addEventListener('click', e => {
  const item = e.target.closest('.item');
  if (item) handleItemClick(item, e);
});

// 選項物件
element.addEventListener(type, listener, {
  capture: false,      // true = 捕獲階段
  passive: false,      // true = 不會呼叫 preventDefault(),滾動/觸控效能優化
  once: false,         // true = 自動移除
  signal: abortSignal  // AbortController 統一移除
});

自訂事件

// 發送
element.dispatchEvent(new CustomEvent('my-event', {
  detail: { foo: 'bar' },
  bubbles: true,
  composed: true  // 穿透 Shadow DOM
}));

// 監聽
element.addEventListener('my-event', e => console.log(e.detail));

記憶體洩漏防範

  • 元素移除前 `removeEventListener` (需保留 listener 參考)。
  • 使用 `AbortController` 統一管理:
    const ac = new AbortController();
    el.addEventListener('click', fn, { signal: ac.signal });
    ac.abort(); // 一次移除所有
  • 避免在循環/頻繁渲染中重複綁定。
copyright © 萬盛學電腦網 all rights reserved