三大屬性對比表
| 屬性 | 含義 | 值範例 | 狀態 |
event.key | 按鍵**字符值**(受 Shift/語系影響) | `'a'`、`'A'`、`'Enter'`、`'ArrowLeft'`、`'死鍵'` | ✅ 標準、推薦 |
event.code | 鍵盤**物理鍵位**(不受修飾鍵影響) | `'KeyA'`、`'Enter'`、`'ArrowLeft'`、`'Numpad1'` | ✅ 標準、推薦 |
event.keyCode | 舊版數值代碼 | `65` (A)、`13` (Enter)、`37` (Left) | ❌ **已棄用** (Deprecated) |
event.which | 舊版別名(同 keyCode) | 同上 | ❌ **已棄用** |
現代標準寫法
<input id="demo" placeholder="按任意鍵…" />
<p id="output"></p>
<script>
const input = document.getElementById('demo');
const out = document.getElementById('output');
input.addEventListener('keydown', e => {
// 單一來源真理:優先用 key,輔助 code
out.textContent = `key: "${e.key}" | code: "${e.code}" | keyCode: ${e.keyCode} (deprecated)`;
// 實用判斷範例
if (e.key === 'Enter') { console.log('送出表單'); }
if (e.code === 'Space') { e.preventDefault(); console.log('空白鍵:遊戲跳躍'); }
if (e.key === 'Escape') { console.log('關閉彈窗'); }
if (e.ctrlKey && e.key === 's') { e.preventDefault(); console.log('Ctrl+S 存檔'); }
});
常見鍵盤代碼速查
| 功能鍵 | key | code |
| Enter | `'Enter'` | `'Enter'` |
| Esc | `'Escape'` | `'Escape'` |
| Tab | `'Tab'` | `'Tab'` |
| Space | `' '` | `'Space'` |
| Backspace | `'Backspace'` | `'Backspace'` |
| Delete | `'Delete'` | `'Delete'` |
| 方向鍵 | `'ArrowUp'` 等 | `'ArrowUp'` 等 |
| F1~F12 | `'F1'`~`'F12'` | `'F1'`~`'F12'` |
| 修飾鍵 | `'Control'`/`'Shift'`/`'Alt'`/`'Meta'` | `'ControlLeft'`/`'ShiftRight'` 等 |
進階場景處理
1. 遊戲輸入:使用 `code` 避免語系/大小寫干擾
const pressed = new Set();
window.addEventListener('keydown', e => pressed.add(e.code));
window.addEventListener('keyup', e => pressed.delete(e.code));
function gameLoop() {
if (pressed.has('ArrowLeft')) movePlayer(-1, 0);
if (pressed.has('ArrowRight')) movePlayer(1, 0);
if (pressed.has('Space')) playerJump();
requestAnimationFrame(gameLoop);
}
2. 表單快捷鍵:`keydown` + `ctrlKey`/`metaKey`/`shiftKey`/`altKey`
document.addEventListener('keydown', e => {
if ((e.ctrlKey || e.metaKey) && e.key === 's') { e.preventDefault(); save(); }
if ((e.ctrlKey || e.metaKey) && e.key === 'z') { e.preventDefault(); undo(); }
if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); submit(); } // Shift+Enter 換行
});
3. 輸入法組合事件(IME):`compositionstart` / `compositionend`
let composing = false;
input.addEventListener('compositionstart', () => composing = true);
input.addEventListener('compositionend', e => {
composing = false;
// 此時 e.data 為確定字串,可觸發搜尋/驗證
handleInput(e.target.value);
});
input.addEventListener('input', e => {
if (!composing) handleInput(e.target.value); // 非組合中直接處理
});
4. 全域快捷鍵註冊表模式
const shortcuts = new Map([
['ctrl+s', save],
['ctrl+shift+z', redo],
['escape', closeModals],
['f1', showHelp]
]);
document.addEventListener('keydown', e => {
const mods = [];
if (e.ctrlKey) mods.push('ctrl');
if (e.shiftKey) mods.push('shift');
if (e.altKey) mods.push('alt');
if (e.metaKey) mods.push('meta');
const combo = [...mods, e.key.toLowerCase()].join('+');
if (shortcuts.has(combo)) {
e.preventDefault();
shortcuts.get(combo)();
}
});
避坑指南
- ❌ 別再用 `keyCode` / `which` / `charCode` —— MDN 標註 **Deprecated**,未來可能移除。
- ❌ `keypress` 事件已棄用,改用 `keydown` + `key` 判斷可列印字符。
- ✅ `key` 用於語意判斷(字符、Enter、Escape),`code` 用於物理位置判斷(遊戲 WASD、快捷鍵)。
- ✅ 監聽 `window`/`document` 捕獲全域快捷鍵,監聽特定 `input`/`textarea` 處理輸入法。
- ✅ `e.repeat` 判斷長按重複觸發,遊戲移動可直接用,文字輸入可選擇忽略。
結語
鍵盤事件處理的核心是:**拋棄 `keyCode`,擁抱 `key` 與 `code`**。前者語意化處理文字與功能鍵,後者物理位置固定適合遊戲與快捷鍵。配合修飾鍵屬性、組合事件、全域註冊表模式,即可構建專業級鍵盤交互體驗。