鍵盤操作是許多互動的基礎——搜尋框的即時篩選、遊戲的方向控制、表單的快顯鍵。JavaScript 提供三個鍵盤事件,但它們的觸發時機、攜帶的資訊與跨瀏覽器差異都值得細究。
keydown:按下的瞬間觸發,長按會連續觸發。能取得所有按鍵(含功能鍵、方向鍵、修飾鍵),並能讀取 ctrlKey、shiftKey 等狀態。
keypress:在 keydown 之後觸發,只對可列印字元有效,功能鍵(F1–F12、方向鍵)不會觸發它。這個事件已被標準標記為不建議使用。
keyup:放開按鍵時觸發。
選擇原則:需要判斷功能鍵時用 keydown,需要取得實際輸入的字元時用 keypress(或更好的方案,見文末)。
function keyDown() {}
document.onkeydown = keyDown; // 無論按下哪個鍵都會呼叫
DOM 標準環境:
function keyDown(e) {
var keycode = e.which; // 鍵值(數字)
var realkey = String.fromCharCode(e.which); // 對應字元
alert("按鍵碼: " + keycode + " 字符: " + realkey);
}
document.onkeydown = keyDown;
舊版 IE:
function keyDown() {
var keycode = event.keyCode;
var realkey = String.fromCharCode(event.keyCode);
alert("按鍵碼: " + keycode + " 字符: " + realkey);
}
document.onkeydown = keyDown;
相容寫法:
function keyUp(e) {
var currKey = 0;
e = e || event;
currKey = e.keyCode || e.which || e.charCode;
var keyName = String.fromCharCode(currKey);
alert("按鍵碼: " + currKey + " 字符: " + keyName);
}
document.onkeyup = keyUp;
要注意的是,keyCode 在標準中已被標記為 deprecated,理由是它反映的是「實體按鍵位置」而非「輸入的字元」,在不同鍵盤配置下會有語意歧義。目前的正確做法是使用 event.key(回傳 'a'、'Enter'、'ArrowLeft' 這樣的字串)搭配 event.code(回傳實體鍵位如 'KeyA')。
以下鍵碼在文字輸入欄位中完全有效;若在 <body> 上使用,只有字母鍵、數字鍵與部分控制鍵可用。字母與數字的鍵碼與 ASCII 值相同。
| 按鍵 | 鍵碼 | 按鍵 | 鍵碼 | 按鍵 | 鍵碼 |
|---|---|---|---|---|---|
| A | 65 | J | 74 | S | 83 |
| B | 66 | K | 75 | T | 84 |
| C | 67 | L | 76 | U | 85 |
| D | 68 | M | 77 | V | 86 |
| E | 69 | N | 78 | W | 87 |
| F | 70 | O | 79 | X | 88 |
| G | 71 | P | 80 | Y | 89 |
| H | 72 | Q | 81 | Z | 90 |
| I | 73 | R | 82 | 0–9 | 48–57 |
| 按鍵 | 鍵碼 | 按鍵 | 鍵碼 | 按鍵 | 鍵碼 |
|---|---|---|---|---|---|
| 0 | 96 | 5 | 101 | Enter | 108 |
| 1 | 97 | 6 | 102 | - | 109 |
| 2 | 98 | 7 | 103 | . | 110 |
| 3 | 99 | 8 | 104 | / | 111 |
| 4 | 100 | 9 | 105 | * + | 106 / 107 |
F1 至 F12 依序對應鍵碼 112 至 123,數字連續且規律,因此可以用 112 <= code && code <= 123 一次判斷。
| 按鍵 | 鍵碼 | 按鍵 | 鍵碼 | 按鍵 | 鍵碼 |
|---|---|---|---|---|---|
| Backspace | 8 | Tab | 9 | Enter | 13 |
| Shift | 16 | Control | 17 | Alt | 18 |
| Caps Lock | 20 | Esc | 27 | Space | 32 |
| Page Up | 33 | Page Down | 34 | End | 35 |
| Home | 36 | Left Arrow | 37 | Up Arrow | 38 |
| Right Arrow | 39 | Down Arrow | 40 | Insert | 45 |
| Delete | 46 | Num Lock | 144 | Clear | 12 |
| 符號 | 鍵碼 | 符號 | 鍵碼 | 符號 | 鍵碼 |
|---|---|---|---|---|---|
| ; : | 186 | = + | 187 | , < | 188 |
| - _ | 189 | . > | 190 | / ? | 191 |
| ` ~ | 192 | [ { | 219 | \ | | 220 |
| ] } | 221 | ' " | 222 |
document.addEventListener('keydown', function (e) {
if (e.key === 'Enter') {
submitForm();
} else if (e.key === 'Escape') {
closeModal();
}
});
對比前面那一大張鍵碼表,現代寫法的可讀性差距非常明顯。除了避免記憶數字,e.key 的另一個優勢是能正確處理鍵盤配置的差異與 IME 中文輸入——在中文輸入法組字階段,keyCode 會持續回傳 229,容易造成誤判,而搭配 event.isComposing 就能可靠地跳過組字中的按鍵:
document.addEventListener('keydown', function (e) {
if (e.isComposing) { return; } // 中文輸入法組字中,不處理
// 這裡才處理實質的按鍵
});
這個判斷在實作搜尋框自動完成、快捷鍵等功能時幾乎是必要的,否則中文使用者會發現每次打字的按鍵都被誤觸發。