萬盛學電腦網

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

JavaScript 鍵盤事件完整指南:keyCode/which/key 跨瀏覽器相容與最佳實務

鍵盤事件處理是前端互動基礎,但歷史上瀏覽器間 keyCode、which、key 差異大、標準演進快。本文完整梳理事件類型、屬性對照、相容寫法與現代最佳實務。

三大鍵盤事件類型

事件觸發時機可取得字元適用場景
keydown按鍵按下❌ (僅鍵碼)遊戲控制、快捷鍵、防重複提交
keypress字元輸入✅輸入驗證、字元過濾 (已棄用)
keyup按鍵釋放❌輸入完成後處理、自動完成

注意:keypress 已從標準移除,僅為相容保留,**新專案請勿使用**。

屬性演進與跨瀏覽器對照

屬性說明狀態相容性
keyCode按鍵代碼 (數字)⚠️ 棄用全瀏覽器支援,但值可能不一致
which同 keyCode (jQuery 正規化)⚠️ 棄用非標準,jQuery 內部統一
key按鍵字串值 ("Enter", "a", "ArrowLeft")✅ 標準現代瀏覽器完整支援
code實體鍵位 ("KeyA", "ArrowLeft")✅ 標準現代瀏覽器支援,不受鍵盤佈局影響
location鍵盤區域 (標準鍵/小鍵盤/左/右)✅ 標準區分左右 Shift/Ctrl/Alt

相容性寫法演進

舊式:keyCode/which 相容

// 經典 jQuery 時代寫法
element.onkeypress = function(e) {
    e = e || window.event;
    var code = e.keyCode || e.which;
    console.log(code);
};

過渡期:key + keyCode 並存

element.addEventListener('keydown', function(e) {
    var key = e.key || String.fromCharCode(e.keyCode);
    // 處理特殊鍵
    if (e.keyCode === 13) { /* Enter */ }
    if (e.key === 'Enter') { /* Enter */ }
});

現代標準:僅使用 key / code

element.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.keye.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

實務應用模式

1. 表單快捷鍵:Ctrl+S 儲存

document.addEventListener('keydown', function(e) {
    if ((e.ctrlKey || e.metaKey) && e.key === 's') {
        e.preventDefault();
        saveForm();
    }
});

2. 遊戲鍵盤狀態追蹤

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);
}

3. 輸入格式化/過濾 (用 beforeinput 或 input 事件)

// 現代方式:input 事件 + 輸入法相容
input.addEventListener('input', function(e) {
    // 只允許數字
    this.value = this.value.replace(/\D/g, '');
});

無障礙與國際化考量

  • key 值會依鍵盤佈局/語系變化 (如 AZERTY 鍵盤 KeyQ 對應 'a')
  • code 固定對應實體鍵位,適合遊戲控制
  • 輸入法組字期間 (IME composition) keydown/keyup 仍會觸發,key 為 "Process" 或 "Unidentified"
  • 使用 compositionstart/end 事件偵測輸入法狀態

總結

棄用 keyCode/which,全面改用 key (語意) 與 code (實體位置)。keydown 處理非字元鍵與快捷鍵,input 事件處理文字輸入。理解修飾鍵、重複觸發、輸入法組字等細節,能建立健壯的鍵盤互動體驗。

copyright © 萬盛學電腦網 all rights reserved