事件分類概覽
DOM Level 3 Events 規範定義了豐富的事件類型,實務上最高頻的三大類別為:
- 滑鼠事件:點擊、移動、拖拽等指標裝置交互
- 鍵盤事件:按鍵按下、字符輸入、釋放
- HTML/視窗事件:載入、錯誤、捲動、表單狀態變化等
一、滑鼠事件詳解
常用事件清單
| 事件 | 觸發時機 | 冒泡 |
click | 單擊(mousedown + mouseup 同一元素) | ✅ |
dblclick | 雙擊 | ✅ |
mousedown | 按鍵按下 | ✅ |
mouseup | 按鍵釋放 | ✅ |
mousemove | 指標移動 | ✅ |
mouseover | 指標進入元素(含子元素冒泡) | ✅ |
mouseout | 指標離開元素(含子元素冒泡) | ✅ |
mouseenter | 指標進入元素(不冒泡,推薦) | ❌ |
mouseleave | 指標離開元素(不冒泡,推薦) | ❌ |
contextmenu | 右鍵選單彈出前 | ✅ |
wheel | 滾輪滾動(現代標準,取代 mousewheel/DOMMouseScroll) | ✅ |
滑鼠事件實戰:統一監聽與座標
<div id="area" style="width:300px;height:200px;background:#f0f0f0;border:1px solid #ccc;">
滑鼠測試區域
</div>
<pre id="log" style="height:200px;overflow:auto;background:#222;color:#0f0;padding:10px;"></pre>
<script>
var area = document.getElementById('area');
var log = document.getElementById('log');
['click','dblclick','mousedown','mouseup','mousemove',
'mouseover','mouseout','mouseenter','mouseleave','contextmenu','wheel']
.forEach(function (type) {
area.addEventListener(type, function (e) {
var msg = '[%s] client:(%d,%d) target:%s'.format(
e.type, e.clientX, e.clientY, e.target.tagName
);
log.textContent += msg + '\n';
log.scrollTop = log.scrollHeight;
});
});
// 簡易 format 輔助
String.prototype.format = function () {
var args = arguments;
return this.replace(/%s|%d/g, function (m) {
return args.shift();
});
};
</script>
button 屬性跨瀏覽器對照
| 操作 | 標準 button | IE8- button | 標準 buttons (位元遮罩) |
| 無按鍵 | - | 0 | 0 |
| 左鍵 | 0 | 1 | 1 |
| 中鍵 | 1 | 4 | 4 |
| 右鍵 | 2 | 2 | 2 |
| 左+右 | - | 3 | 3 |
建議:現代專案直接使用 e.buttons & 1 判斷左鍵、e.buttons & 2 判斷右鍵、e.buttons & 4 判斷中鍵,無需關心歷史差異。
二、鍵盤事件深度解析
三大核心事件
| 事件 | 觸發階段 | 特點 |
keydown | 按鍵按下 | 長按會重複觸發;可攔截所有按鍵(含功能鍵) |
keypress | 產生字符時 | 已棄用;忽略 Shift/Ctrl/Alt 等非字符鍵;charCode 僅此事件可靠 |
keyup | 按鍵釋放 | 單次觸發;適合最終確認輸入 |
關鍵屬性對照
| 屬性 | 含義 | 備註 |
key | 按鍵字符值(如 "Enter"、"a"、"ArrowLeft") | 現代標準,推薦使用 |
code | 鍵盤物理鍵位(如 "KeyA"、"Enter") | 不受鍵盤佈局影響,適合遊戲/快捷鍵 |
keyCode | 歷史鍵碼(如 13=Enter) | 已棄用,但仍廣泛用於舊代碼 |
charCode | 字符碼(僅 keypress 有效) | 已棄用 |
ctrlKey/shiftKey/altKey/metaKey | 修飾鍵狀態 | 全事件通用 |
鍵盤事件實戰:即時字符統計與快捷鍵
<textarea id="editor" rows="6" cols="60" placeholder="試著輸入...></textarea>
<div>字符數: <span id="charCount">0</span> | 最後鍵: <span id="lastKey">-</span></div>
<script>
var editor = document.getElementById('editor');
var charCount = document.getElementById('charCount');
var lastKey = document.getElementById('lastKey');
editor.addEventListener('input', function () {
charCount.textContent = editor.value.length;
});
// 快捷鍵示例:Ctrl+S 阻止預設存檔並提示
editor.addEventListener('keydown', function (e) {
lastKey.textContent = e.key + ' (code:' + e.code + ')';
if (e.ctrlKey && e.key === 's') {
e.preventDefault();
alert('觸發自定義儲存邏輯!');
}
});
</script>
三、HTML / 視窗事件精選
| 事件 | 目標 | 典型用途 |
load | window / img / script / iframe | 資源完全載入後初始化 |
DOMContentLoaded | document | HTML 解析完成、DOM 就緒(不等圖片),優先於 load |
beforeunload | window | 離頁確認(返回字串觸發瀏覽器原生提示) |
unload | window | 頁面卸載(不可阻止,僅做清理) |
resize | window | 視窗尺寸變化(建議 debounce) |
scroll | window / 可捲動元素 | 捲動監聽(建議 passive + throttle) |
error | img / script / window | 資源載入失敗、JS 運行時錯誤 |
change | input / select / textarea | 值提交時改變(失焦或選擇後) |
input | input / textarea | 即時輸入(含中文輸入法合成) |
submit | form | 表單提交前驗證/攔截 |
reset | form | 表單重置 |
focus/blur | 可聚焦元素 | 聚焦/失焦(不冒泡,捕獲階段用 focusin/focusout) |
select | input / textarea | 文字被選取 |
load vs DOMContentLoaded 選擇指南
- 需等待圖片/樣式表完成渲染 →
window.onload
- 僅需 DOM 結構就緒 →
document.addEventListener('DOMContentLoaded', ...)(更快)
現代事件綁定最佳實踐
// 1. 統一使用 addEventListener,支援多監聽器
element.addEventListener('click', handler, false); // 冒泡階段
element.addEventListener('click', handler, {capture: true}); // 捕獲階段
// 2. 選項物件(現代瀏覽器)
element.addEventListener('scroll', onScroll, {passive: true}); // 不阻塞主執行緒
element.addEventListener('touchstart', onTouch, {passive: false}); // 需 preventDefault
// 3. 一次性監聽器
element.addEventListener('click', onceHandler, {once: true}); // 自動移除
// 4. 移除監聽器必須同函式引用
function handler() { ... }
element.addEventListener('click', handler);
element.removeEventListener('click', handler); // 僅此方式有效
結語
事件類型繁多但規律清晰:滑鼠關注座標與按鍵,鍵盤關注 key/code 與修飾鍵,HTML 事件關注生命週期與表單狀態。掌握核心屬性差異、棄用屬性替代方案、以及現代綁定選項,即能編寫高效、相容、可維護的交互代碼。