萬盛學電腦網

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

JavaScript 鍵盤事件攔截:屏蔽與改鍵完整實作

網頁應用常需攔截特定按鍵(如禁用 F5 重新整理、Backspace 返回、右鍵選單)或改變按鍵行為(Enter 送出表單、方向鍵導航)。本文提供完整鍵碼對照表與實作模式。

常用鍵碼對照表

按鍵keyCodekey (現代)code (現代)
F1 - F12112 - 123F1 - F12F1 - F12
A - Z65 - 90a - zKeyA - KeyZ
0 - 948 - 570 - 9Digit0 - Digit9
Esc27EscapeEscape
Backspace8BackspaceBackspace
Enter13EnterEnter
Shift16ShiftShiftLeft/Right
Ctrl17ControlControlLeft/Right
Alt18AltAltLeft/Right
Space32SpaceSpace
Insert45InsertInsert
Delete46DeleteDelete

現代事件處理:使用 key / code 而非 keyCode

keyCode、which、charCode 已棄用。現代標準使用:

  • event.key:按鍵字元值(含修飾鍵組合)
  • event.code:鍵盤物理位置(不受佈局影響)

屏蔽特定按鍵

<script>
document.addEventListener('keydown', function(e) {
    // 屏蔽 F1-F12
    if (e.key.startsWith('F') && Number(e.key.slice(1)) <= 12) {
        e.preventDefault();
        return;
    }
    
    // 屏蔽 Backspace(非輸入框時防止誤觸返回)
    if (e.key === 'Backspace' && !isEditableTarget(e.target)) {
        e.preventDefault();
        return;
    }
    
    // 屏蔽 Ctrl+S、Ctrl+P 等瀏覽器快捷鍵
    if (e.ctrlKey && ['s', 'p', 'u'].includes(e.key.toLowerCase())) {
        e.preventDefault();
        return;
    }
});

function isEditableTarget(el) {
    const tag = el.tagName.toLowerCase();
    return tag === 'input' || tag === 'textarea' || tag === 'select' || el.isContentEditable;
}
</script>

改變按鍵行為:Enter 送出表單

<form id="loginForm">
    <input type="text" name="username" placeholder="帳號">
    <input type="password" name="password" placeholder="密碼">
    <button type="submit" id="loginBtn">登入</button>
</form>

<script>
const form = document.getElementById('loginForm');
const loginBtn = document.getElementById('loginBtn');

// 表單內 Enter 觸發提交
form.addEventListener('keydown', function(e) {
    if (e.key === 'Enter' && e.target.tagName !== 'TEXTAREA') {
        e.preventDefault(); // 防止換行
        loginBtn.click();   // 觸發提交按鈕
    }
});

// 或直接監聽表單 submit 事件(推薦)
form.addEventListener('submit', function(e) {
    e.preventDefault();
    // AJAX 提交邏輯
    console.log('表單提交:', new FormData(this));
});
</script>

進階:自訂快捷鍵系統

class HotkeyManager {
    constructor() {
        this.bindings = new Map();
        document.addEventListener('keydown', e => this.handleKey(e));
    }
    
    // 註冊:hotkeyManager.register('Ctrl+S', () => save())
    register(combo, callback) {
        this.bindings.set(this.normalize(combo), callback);
    }
    
    normalize(combo) {
        return combo.toLowerCase()
            .replace(/\s+/g, '')
            .split('+')
            .sort()
            .join('+');
    }
    
    handleKey(e) {
        const parts = [];
        if (e.ctrlKey) parts.push('ctrl');
        if (e.altKey) parts.push('alt');
        if (e.shiftKey) parts.push('shift');
        if (e.metaKey) parts.push('meta');
        parts.push(e.key.toLowerCase());
        
        const combo = parts.sort().join('+');
        const callback = this.bindings.get(combo);
        if (callback) {
            e.preventDefault();
            callback(e);
        }
    }
}

// 使用
const hotkeys = new HotkeyManager();
hotkeys.register('ctrl+s', e => { console.log('儲存'); /* save() */ });
hotkeys.register('ctrl+shift+z', e => { console.log('重做'); /* redo() */ });
hotkeys.register('f2', e => { console.log('重新命名'); /* rename() */ });

右鍵選單攔截

// 禁用右鍵選單
document.addEventListener('contextmenu', e => e.preventDefault());

// 或針對特定區域
document.getElementById('protectedArea').addEventListener('contextmenu', e => e.preventDefault());

注意事項與最佳實務

  1. 不可過度攔截:瀏覽器內建快捷鍵(Ctrl+T、Ctrl+W、Alt+F4 等)無法被 JS 攔截,也不應嘗試
  2. 無障礙:確保鍵盤導航功能完整,Tab 鍵、方向鍵、Enter、Esc 必須正常運作
  3. 輸入框排除:屏蔽 Backspace、Enter 等鍵時,務必排除輸入框、textarea、contenteditable 元素
  4. 事件階段:keydown 可防大多數行為,keypress 已棄用,keyup 無法防預設行為
  5. 跨平台差異:Mac 使用 Cmd (Meta) 鍵對應 Windows Ctrl,註冊快捷鍵時同時支援

總結

使用 event.key 和 event.code 替代棄用的 keyCode。屏蔽按鍵用 e.preventDefault(),改鍵行為在 keydown 階段處理。建立統一的熱鍵管理系統可提升大型應用的可維護性。

copyright © 萬盛學電腦網 all rights reserved