萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 捕獲鍵盤按鍵:`key`、`code`、`keyCode` 差異與最佳實踐

三大屬性對比表

屬性含義值範例狀態
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 存檔'); }
});

常見鍵盤代碼速查

功能鍵keycode
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`**。前者語意化處理文字與功能鍵,後者物理位置固定適合遊戲與快捷鍵。配合修飾鍵屬性、組合事件、全域註冊表模式,即可構建專業級鍵盤交互體驗。

copyright © 萬盛學電腦網 all rights reserved