三大鍵盤事件差異
| 事件 | 觸發時機 | 適用按鍵 | 字符資訊 | 重複觸發 |
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();
}
});
瀏覽器差異歷史對照 (參考用,現代專案可忽略)
| 屬性 | IE | Firefox | Chrome/Edge | Safari |
| keydown.keyCode | 虛擬鍵碼 | 0 | 虛擬鍵碼 | 虛擬鍵碼 |
| keydown.which | undefined | 虛擬鍵碼 | 虛擬鍵碼 | 虛擬鍵碼 |
| keypress.keyCode | 字符碼 | 0 | 字符碼 | 字符碼 |
| keypress.which | undefined | 字符碼 | 字符碼 | 字符碼 |
| keypress.charCode | undefined | 字符碼 | 字符碼 | 字符碼 |
| 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)