萬盛學電腦網

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

JavaScript 鍵盤事件完整指南:keydown/keypress/keyup 跨瀏覽器相容與最佳實踐

三大鍵盤事件差異

事件觸發時機適用按鍵字符資訊重複觸發
keydown按下瞬間所有按鍵 (含功能鍵)keyCode (虛擬鍵碼)✅ 長按重複
keypress字符輸入可列印字符鍵charCode (字符碼)✅ 長按重複
keyup釋放瞬間所有按鍵keyCode❌ 不重複

關鍵:keypress 已棄用 (Deprecated),現代開發請使用 keydown + event.key。

跨瀏覽器事件物件標準化


function normalizeKeyboardEvent(e) {
    e = e || window.event; // IE 相容
    
    // 統一鍵碼取得
    var keyCode = e.keyCode || e.which || e.charCode;
    
    // 現代標準屬性 (優先使用)
    var key = e.key;           // "Enter", "ArrowLeft", "a", "1", "F1"
    var code = e.code;         // "Enter", "ArrowLeft", "KeyA", "Digit1", "F1" (物理鍵位)
    var char = e.char;         // 輸入字符 (已棄用,用 key 判斷)
    
    // 修飾鍵狀態 (標準化)
    var ctrl = e.ctrlKey || e.metaKey; // Mac Cmd 視同 Ctrl
    var shift = e.shiftKey;
    var alt = e.altKey;
    
    return {
        originalEvent: e,
        keyCode: keyCode,
        key: key,
        code: code,
        ctrlKey: ctrl,
        shiftKey: shift,
        altKey: alt,
        // 便利判斷
        isEnter: key === 'Enter' || keyCode === 13,
        isEscape: key === 'Escape' || keyCode === 27,
        isTab: key === 'Tab' || keyCode === 9,
        isArrow: /^Arrow/.test(key),
        isModifier: key === 'Control' || key === 'Shift' || key === 'Alt' || key === 'Meta'
    };
}

// 使用
document.addEventListener('keydown', function(e) {
    var k = normalizeKeyboardEvent(e);
    if (k.isEnter && k.ctrlKey) {
        e.preventDefault();
        submitForm();
    }
});

瀏覽器差異歷史對照 (參考用,現代專案可忽略)

屬性IEFirefoxChrome/EdgeSafari
keydown.keyCode虛擬鍵碼0虛擬鍵碼虛擬鍵碼
keydown.whichundefined虛擬鍵碼虛擬鍵碼虛擬鍵碼
keypress.keyCode字符碼0字符碼字符碼
keypress.whichundefined字符碼字符碼字符碼
keypress.charCodeundefined字符碼字符碼字符碼
keyup.keyCode虛擬鍵碼0虛擬鍵碼虛擬鍵碼

常用鍵碼對照表 (keyCode / key / code)


const KEY_MAP = {
    8:   { key: 'Backspace', code: 'Backspace' },
    9:   { key: 'Tab',       code: 'Tab' },
    13:  { key: 'Enter',     code: 'Enter' },
    16:  { key: 'Shift',     code: 'ShiftLeft/Right' },
    17:  { key: 'Control',   code: 'ControlLeft/Right' },
    18:  { key: 'Alt',       code: 'AltLeft/Right' },
    27:  { key: 'Escape',    code: 'Escape' },
    32:  { key: ' ',         code: 'Space' },
    37:  { key: 'ArrowLeft', code: 'ArrowLeft' },
    38:  { key: 'ArrowUp',   code: 'ArrowUp' },
    39:  { key: 'ArrowRight',code: 'ArrowRight' },
    40:  { key: 'ArrowDown', code: 'ArrowDown' },
    46:  { key: 'Delete',    code: 'Delete' },
    91:  { key: 'Meta',      code: 'MetaLeft' }, // Win/Cmd
    112: { key: 'F1',        code: 'F1' },
    // ... F2-F12: 113-123
};

實戰:鍵盤快捷鍵系統


class HotkeyManager {
    constructor() {
        this.bindings = new Map(); // "ctrl+s" -> [callbacks]
        this.pressed = new Set();  // 當前按下的修飾鍵
        this.init();
    }
    
    init() {
        document.addEventListener('keydown', this.onDown.bind(this));
        document.addEventListener('keyup', this.onUp.bind(this));
    }
    
    onDown(e) {
        // 記錄修飾鍵狀態
        if (e.key === 'Control') this.pressed.add('ctrl');
        if (e.key === 'Shift') this.pressed.add('shift');
        if (e.key === 'Alt') this.pressed.add('alt');
        if (e.key === 'Meta') this.pressed.add('meta');
        
        // 建立組合鍵字串
        var combo = this.getComboString(e);
        if (this.bindings.has(combo)) {
            e.preventDefault(); // 阻止瀏覽器預設行為 (如 Ctrl+S 存檔)
            this.bindings.get(combo).forEach(fn => fn(e));
        }
    }
    
    onUp(e) {
        this.pressed.delete('ctrl');
        this.pressed.delete('shift');
        this.pressed.delete('alt');
        this.pressed.delete('meta');
    }
    
    getComboString(e) {
        var parts = [];
        if (this.pressed.has('ctrl')) parts.push('ctrl');
        if (this.pressed.has('shift')) parts.push('shift');
        if (this.pressed.has('alt')) parts.push('alt');
        if (this.pressed.has('meta')) parts.push('meta');
        parts.push(e.key.toLowerCase());
        return parts.join('+');
    }
    
    // 註冊快捷鍵
    bind(combo, callback) {
        // combo 格式: "ctrl+s", "ctrl+shift+p", "f1"
        var normalized = combo.toLowerCase().replace(/\s+/g, '');
        if (!this.bindings.has(normalized)) this.bindings.set(normalized, []);
        this.bindings.get(normalized).push(callback);
    }
    
    unbind(combo, callback) {
        var normalized = combo.toLowerCase().replace(/\s+/g, '');
        if (this.bindings.has(normalized)) {
            var arr = this.bindings.get(normalized);
            var idx = arr.indexOf(callback);
            if (idx > -1) arr.splice(idx, 1);
        }
    }
}

// 使用
var hotkeys = new HotkeyManager();
hotkeys.bind('ctrl+s', (e) => { e.preventDefault(); saveDraft(); });
hotkeys.bind('ctrl+shift+p', () => openCommandPalette());
hotkeys.bind('escape', () => closeModals());
hotkeys.bind('f1', () => showHelp());

輸入法編輯 (IME) 處理


// compositionstart/compositionend 區分中文輸入中間態
var isComposing = false;

input.addEventListener('compositionstart', () => isComposing = true);
input.addEventListener('compositionend', (e) => {
    isComposing = false;
    // 此時 e.data 為確認的字符,可觸發搜尋/驗證
    handleInput(e.target.value);
});

input.addEventListener('input', (e) => {
    if (!isComposing) {
        // 直接輸入 (英文、數字、貼上、刪除)
        handleInput(e.target.value);
    }
});

無障礙與 UX 建議

  • 所有互動元素可鍵盤聚焦 (tabindex、語意化 HTML)
  • 焦點指示器清晰可見 (:focus-visible)
  • 提供快捷鍵說明 (Help 對話框、工具提示)
  • 避免與瀏覽器/系統快捷鍵衝突 (Ctrl+T/W/N/R 等)
  • 修飾鍵組合優先用 Ctrl (Win/Linux) / Meta (Mac)
copyright © 萬盛學電腦網 all rights reserved