三大事件對比表
| 特性 | keydown | keypress | keyup |
| 觸發時機 | 按鍵**按下**瞬間 | 字符**輸入**瞬間 (按下並產生字符) | 按鍵**釋放**瞬間 |
| 觸發順序 | 1️⃣ 最先 | 2️⃣ 緊隨 keydown (僅字符鍵) | 3️⃣ 最後 |
| 非字符鍵 (Shift, Ctrl, 方向鍵, F1-F12...) | ✅ 觸發 | ❌ **不觸發** | ✅ 觸發 |
| 字符大小寫區分 | ❌ keyCode 相同 | ✅ charCode 不同 | ❌ |
| 組合鍵檢測 | ✅ ctrlKey/shiftKey/altKey/metaKey | ❌ | ✅ |
| 長按重複觸發 | ✅ (瀏覽器/OS 重複率) | ✅ (同 keydown) | ❌ (僅釋放觸發一次) |
| 可阻止默認行為 | ✅ preventDefault() | ✅ | ❌ (已發生) |
| 標準屬性 (現代) | key, code | key (字符) | key, code |
| 棄用屬性 | keyCode, which | keyCode, charCode, which | keyCode, which |
關鍵差異深度解析
1. keypress 僅限字符鍵
input.addEventListener('keypress', e => {
// 只能捕獲可打印字符:字母、數字、符號、空格
// 無法捕獲: Backspace, Delete, Enter, 方向鍵, Ctrl, Alt, Shift, F1-F12
console.log('字符:', e.key); // 現代用 e.key
});
2. 獲取字符的標準方式:e.key (ES2015+)
input.addEventListener('keydown', e => {
if (e.key === 'Enter') { /* 回車 */ }
if (e.key === 'Escape') { /* ESC */ }
if (e.key.length === 1 && !e.ctrlKey && !e.altKey && !e.metaKey) {
// 可打印字符 (粗略判斷)
}
});
3. 物理鍵位不受佈局影響:e.code
// e.code 表示鍵盤物理位置,如 'KeyA', 'Digit1', 'ArrowLeft', 'ControlLeft'
document.addEventListener('keydown', e => {
if (e.code === 'Space') { /* 空格鍵,無論輸入法狀態 */ }
});
4. 組合鍵檢測只能用 keydown/keyup
document.addEventListener('keydown', e => {
if (e.ctrlKey && e.key === 's') {
e.preventDefault(); // 阻止瀏覽器保存
saveDocument();
}
});
實戰選擇指南
| 需求 | 推薦事件 | 理由 |
| 表單輸入過濾/統計字符 | keypress / beforeinput (新標準) | 直接獲取將輸入的字符 |
| 快捷鍵 (Ctrl+S, Ctrl+Z...) | keydown | 捕獲組合鍵、非字符鍵、可防默認 |
| 遊戲移動控制 (長按移動) | keydown + keyup 維護按鍵狀態表 | 長按 keydown 重複觸發,keyup 重置 |
| 輸入法組合輸入 | compositionstart/update/end | keypress/keydown 在組合期間行為不一 |
| 通用鍵盤日誌/調試 | keydown | 捕獲所有按鍵,含修飾鍵 |
現代最佳實踐:統一用 keydown + e.key/e.code
function handleKey(e) {
switch (e.key) {
case 'Enter': submit(); break;
case 'Escape': closeModal(); break;
case 'ArrowLeft': move(-1); break;
case 'ArrowRight': move(1); break;
default:
if (e.key.length === 1 && !e.ctrlKey && !e.altKey && !e.metaKey) {
typeCharacter(e.key); // 普通字符
}
}
}
document.addEventListener('keydown', handleKey);
避坑提示
keypress 已棄用** (MDN 標記 Deprecated),新項目勿用,改用 beforeinput 或 keydown + e.key。
- 不要用
keyCode/which/charCode,已棄用,數值含義混亂 (如 keyCode=65 同時代表 'A' 和 'a')。
- 輸入法編輯中 (IME):
keydown 會觸發但 e.key 為 'Process' 或 'Dead',需配合 compositionstart/end 處理中文/日文輸入。
- 自動重複:長按字符鍵會連續觸發
keydown + keypress,遊戲需用 Set 記錄按下狀態而非依賴事件頻率。