做鍵盤快捷鍵、方向鍵控制、Enter 送出等功能時,第一步都是「取得使用者按了哪個鍵」。這份小範例示範如何即時抓出按鍵的 keyCode 並顯示出來,是很適合用來查表的除錯工具。
<!DOCTYPE html>
<html>
<head>
<script>
function showKeyCode(event) {
document.getElementById("result").value = event.keyCode;
}
</script>
</head>
<body onkeyup="showKeyCode(event)">
<p>按下鍵盤上的鍵,下方文本框會顯示對應的 code</p>
<input type="text" id="result" value="" />
</body>
</html>
三個鍵盤事件並非等價,選錯會拿不到想要的結果:
keyCode 代表按鍵在鍵盤上的位置,方向鍵、功能鍵、Ctrl 等都能抓到。keyCode 其實是字元編碼。這個事件已被標示為 deprecated,不建議再用。實務上的搭配原則:需要在輸入值變更前攔截(例如阻止非數字輸入)用 keydown;需要在值確定後讀取(例如即時搜尋)用 keyup。
keyCode 已被標示為 deprecated,新專案請改用標準的 key 與 code:
document.addEventListener('keydown', function(e) {
console.log('key :', e.key); // 實際產生的字元,如 'a'、'A'、'Enter'、'ArrowLeft'
console.log('code:', e.code); // 實體按鍵位置,如 'KeyA'、'Enter'、'ArrowLeft'
console.log(' modifiers:', e.ctrlKey, e.shiftKey, e.altKey, e.metaKey);
});
兩者的差別很重要:key 受鍵盤配置與 Shift 影響(同一顆按鍵可能是 'a' 或 'A'),code 則代表實體位置(永遠是 'KeyA')。做 WASD 遊戲控制要固定用 code,做「使用者輸入的字母」判斷則用 key。
舊寫法中常見的幾個:13 是 Enter、27 是 Esc、32 是空白鍵、37~40 是左右上下方向鍵、8 是 Backspace、9 是 Tab、46 是 Delete。對應的新寫法分別是 'Enter'、'Escape'、' '、'ArrowLeft'~'ArrowDown'、'Backspace'、'Tab'、'Delete'。
最後提醒,別忘了監聽 document 而不是某個特定元素,全域快捷鍵才不會因為焦點位置而失效;同時要留意不要在使用者正在輸入文字時攔截按鍵,否則會造成操作障礙。