鍵盤事件處理是前端互動基礎,但歷史上瀏覽器間 keyCode、which、key 差異大、標準演進快。本文完整梳理事件類型、屬性對照、相容寫法與現代最佳實務。
| 事件 | 觸發時機 | 可取得字元 | 適用場景 |
|---|---|---|---|
keydown | 按鍵按下 | ❌ (僅鍵碼) | 遊戲控制、快捷鍵、防重複提交 |
keypress | 字元輸入 | ✅ | 輸入驗證、字元過濾 (已棄用) |
keyup | 按鍵釋放 | ❌ | 輸入完成後處理、自動完成 |
注意:keypress 已從標準移除,僅為相容保留,**新專案請勿使用**。
| 屬性 | 說明 | 狀態 | 相容性 |
|---|---|---|---|
keyCode | 按鍵代碼 (數字) | ⚠️ 棄用 | 全瀏覽器支援,但值可能不一致 |
which | 同 keyCode (jQuery 正規化) | ⚠️ 棄用 | 非標準,jQuery 內部統一 |
key | 按鍵字串值 ("Enter", "a", "ArrowLeft") | ✅ 標準 | 現代瀏覽器完整支援 |
code | 實體鍵位 ("KeyA", "ArrowLeft") | ✅ 標準 | 現代瀏覽器支援,不受鍵盤佈局影響 |
location | 鍵盤區域 (標準鍵/小鍵盤/左/右) | ✅ 標準 | 區分左右 Shift/Ctrl/Alt |
// 經典 jQuery 時代寫法
element.onkeypress = function(e) {
e = e || window.event;
var code = e.keyCode || e.which;
console.log(code);
};
element.addEventListener('keydown', function(e) {
var key = e.key || String.fromCharCode(e.keyCode);
// 處理特殊鍵
if (e.keyCode === 13) { /* Enter */ }
if (e.key === 'Enter') { /* Enter */ }
});
key / codeelement.addEventListener('keydown', function(e) {
switch (e.key) {
case 'Enter': submitForm(); break;
case 'Escape': closeModal(); break;
case 'ArrowLeft': moveLeft(); break;
case 'ArrowRight': moveRight(); break;
case 'Tab': handleTab(e); break;
}
// 修飾鍵檢查
if (e.ctrlKey && e.key === 's') {
e.preventDefault(); // 阻止瀏覽器儲存
saveDocument();
}
});
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>鍵盤事件測試</title>
<style>
.key-info {
font-family: monospace;
background: #f5f5f5;
padding: 10px;
border-radius: 4px;
margin: 10px 0;
white-space: pre-wrap;
}
kbd {
background: #eee;
border: 1px solid #ccc;
border-radius: 3px;
padding: 2px 6px;
}
</style>
</head>
<body>
<h3>按下任意鍵查看事件資訊</h3>
<div id="output" class="key-info">等待輸入...</div>
<script>
document.addEventListener('keydown', function(e) {
var info = [
'事件類型: ' + e.type,
'key: ' + e.key,
'code: ' + e.code,
'location: ' + e.location,
'keyCode (棄用): ' + e.keyCode,
'which (棄用): ' + e.which,
'修飾鍵: Ctrl=' + e.ctrlKey + ' Alt=' + e.altKey + ' Shift=' + e.shiftKey + ' Meta=' + e.metaKey,
'repeat: ' + e.repeat
].join('\n');
document.getElementById('output').textContent = info;
});
</script>
</body>
</html>
| 按鍵 | e.key | e.code | 舊 keyCode |
|---|---|---|---|
| Enter | "Enter" | "Enter" | 13 |
| Esc | "Escape" | "Escape" | 27 |
| Space | " " | "Space" | 32 |
| 左鍵 | "ArrowLeft" | "ArrowLeft" | 37 |
| 上鍵 | "ArrowUp" | "ArrowUp" | 38 |
| 右鍵 | "ArrowRight" | "ArrowRight" | 39 |
| 下鍵 | "ArrowDown" | "ArrowDown" | 40 |
| Tab | "Tab" | "Tab" | 9 |
| Backspace | "Backspace" | "Backspace" | 8 |
| Delete | "Delete" | "Delete" | 46 |
| F1-F12 | "F1"~"F12" | "F1"~"F12" | 112-123 |
document.addEventListener('keydown', function(e) {
if ((e.ctrlKey || e.metaKey) && e.key === 's') {
e.preventDefault();
saveForm();
}
});
var keys = {};
document.addEventListener('keydown', e => keys[e.code] = true);
document.addEventListener('keyup', e => keys[e.code] = false);
function gameLoop() {
if (keys['ArrowLeft']) player.x -= 5;
if (keys['ArrowRight']) player.x += 5;
if (keys['Space']) player.jump();
requestAnimationFrame(gameLoop);
}
beforeinput 或 input 事件)// 現代方式:input 事件 + 輸入法相容
input.addEventListener('input', function(e) {
// 只允許數字
this.value = this.value.replace(/\D/g, '');
});
key 值會依鍵盤佈局/語系變化 (如 AZERTY 鍵盤 KeyQ 對應 'a')code 固定對應實體鍵位,適合遊戲控制keydown/keyup 仍會觸發,key 為 "Process" 或 "Unidentified"compositionstart/end 事件偵測輸入法狀態棄用 keyCode/which,全面改用 key (語意) 與 code (實體位置)。keydown 處理非字元鍵與快捷鍵,input 事件處理文字輸入。理解修飾鍵、重複觸發、輸入法組字等細節,能建立健壯的鍵盤互動體驗。