事件分類總覽
| 類別 | 事件 | 觸發時機 | 常用屬性/方法 |
| 滑鼠 | click | 點擊(mousedown + mouseup 同一元素) | clientX/Y, button, detail |
dblclick | 雙擊 | detail=2 |
mousedown | 按下滑鼠鍵 | button(0左/1中/2右) |
mouseup | 釋放滑鼠鍵 | |
mousemove | 滑鼠移動 | clientX/Y, movementX/Y |
mouseover | 進入元素(冒泡) | relatedTarget |
mouseout | 離開元素(冒泡) | relatedTarget |
mouseenter | 進入元素(不冒泡) | 推薦搭配 mouseleave |
mouseleave | 離開元素(不冒泡) | |
contextmenu | 右鍵選單 | e.preventDefault() 可禁用 |
wheel | 滾輪滾動 | deltaX/Y/Z, deltaMode |
| 鍵盤 | keydown | 按鍵按下(持續觸發) | key, code, keyCode(棄用), ctrlKey/shiftKey/altKey/metaKey |
keyup | 按鍵釋放 | |
keypress | 字元輸入(已棄用) | charCode, 已移除標準,勿用 |
input | 輸入框值改變 | e.target.value, inputType, isComposing |
| 視窗/文件 | load | 頁面/資源完全載入 | |
DOMContentLoaded | HTML 解析完成(不等 CSS/圖片) | 最早啟動 JS 的時機 |
beforeunload | 離開頁面前 | e.preventDefault(), e.returnValue='' 彈出確認 |
unload | 頁面卸載 | 無法阻止,僅能做同步清理 |
resize | 視窗大小改變 | window.innerWidth/Height |
scroll | 捲動 | window.scrollY, element.scrollTop |
visibilitychange | 分頁顯示/隱藏切換 | document.hidden, document.visibilityState |
online/offline | 網路狀態變化 | navigator.onLine |
| 表單 | focus | 獲得焦點(不冒泡) | focusin 冒泡版 |
blur | 失去焦點(不冒泡) | focusout 冒泡版 |
change | 值變更並失去焦點(select、checkbox 即時) | |
input | 值即時改變 | inputType, data, isComposing |
submit | 表單提交 | e.preventDefault() 阻止 |
reset | 表單重置 | |
select | 文字被選取 | e.target.selectionStart/End |
invalid | 驗證失敗 | HTML5 表單驗證 |
| 觸控/指標 | touchstart/move/end/cancel | 觸控螢幕 | touches, targetTouches, changedTouches |
pointerdown/move/up/cancel | 統一滑鼠/觸控/筆 | pointerType, isPrimary, pressure |
gotpointercapture/lostpointercapture | 捕獲指標 | setPointerCapture() |
gesturestart/change/end | 多點手勢(Safari) | rotation, scale |
| 剪貼簿 | copy/cut/paste | 複製/剪下/貼上 | e.clipboardData.getData/setData |
beforecopy/cut/paste | 執行前 | 可修改/阻止 |
dragstart/drag/dragend/drop | 拖放 | e.dataTransfer |
事件流:捕獲 → 目標 → 冒泡
// 捕獲階段監聽(第三參數 true 或 {capture: true})
element.addEventListener('click', handler, true);
// 冒泡階段(預設)
element.addEventListener('click', handler);
// 阻止傳播
e.stopPropagation(); // 停止冒泡/捕獲繼續
e.stopImmediatePropagation(); // 同元素其他監聽器也不執行
// 阻止預設行為
e.preventDefault(); // 如連結跳轉、表單提交、右鍵選單
// 回傳 false(僅內聯/屬性綁定有效)
// onclick="return false;"
事件物件常用屬性速查
| 屬性 | 適用事件 | 說明 |
target | 所有 | 實際觸發事件的元素 |
currentTarget | 所有 | 綁定監聽器的元素(this) |
relatedTarget | mouseover/out, focus/blur | 進入/離開的另一元素 |
clientX/Y | 滑鼠/觸控 | 相對視窗座標 |
pageX/Y | 滑鼠 | 相對文件座標(含捲動) |
offsetX/Y | 滑鼠 | 相對目標元素邊框座標 |
key | 鍵盤 | 字元值("Enter", "a", "F1") |
code | 鍵盤 | 實體鍵位("KeyA", "Enter") |
buttons | 滑鼠 | 當前按下的鍵位元遮罩 |
detail | click/dblclick | 點擊次數 |
composedPath() | 所有 | 事件傳播路徑陣列(含 Shadow DOM) |
事件代理模式(效能最佳實踐)
// 不在每個 li 綁定,改在 ul 綁一個
document.getElementById('list').addEventListener('click', e => {
const li = e.target.closest('li[data-id]');
if (li) {
const id = li.dataset.id;
handleItemClick(id, e);
}
});
function handleItemClick(id, e) {
console.log('項目點擊:', id);
}
被動事件監聽器
// 告訴瀏覽器 handler 不會呼叫 preventDefault(),可優化滾動效能
element.addEventListener('touchmove', handler, {passive: true});
element.addEventListener('wheel', handler, {passive: true});
// 需要 preventDefault 時設 false
element.addEventListener('touchstart', handler, {passive: false});
自訂事件
// 建立並派發
const event = new CustomEvent('my-event', {
detail: {userId: 123, action: 'login'},
bubbles: true,
cancelable: true
});
element.dispatchEvent(event);
// 監聽
element.addEventListener('my-event', e => {
console.log(e.detail.userId); // 123
});