萬盛學電腦網

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

JavaScript 鍵盤事件詳解:keydown、keypress、keyup 區別與最佳實踐

三大事件對比表

特性keydownkeypresskeyup
觸發時機按鍵**按下**瞬間字符**輸入**瞬間 (按下並產生字符)按鍵**釋放**瞬間
觸發順序1️⃣ 最先2️⃣ 緊隨 keydown (僅字符鍵)3️⃣ 最後
非字符鍵 (Shift, Ctrl, 方向鍵, F1-F12...)✅ 觸發❌ **不觸發**✅ 觸發
字符大小寫區分❌ keyCode 相同✅ charCode 不同❌
組合鍵檢測✅ ctrlKey/shiftKey/altKey/metaKey❌✅
長按重複觸發✅ (瀏覽器/OS 重複率)✅ (同 keydown)❌ (僅釋放觸發一次)
可阻止默認行為✅ preventDefault()✅❌ (已發生)
標準屬性 (現代)key, codekey (字符)key, code
棄用屬性keyCode, whichkeyCode, charCode, whichkeyCode, which

關鍵差異深度解析

1. keypress 僅限字符鍵

input.addEventListener('keypress', e => {
  // 只能捕獲可打印字符:字母、數字、符號、空格
  // 無法捕獲: Backspace, Delete, Enter, 方向鍵, Ctrl, Alt, Shift, F1-F12
  console.log('字符:', e.key); // 現代用 e.key
});

2. 獲取字符的標準方式:e.key (ES2015+)

input.addEventListener('keydown', e => {
  if (e.key === 'Enter') { /* 回車 */ }
  if (e.key === 'Escape') { /* ESC */ }
  if (e.key.length === 1 && !e.ctrlKey && !e.altKey && !e.metaKey) {
    // 可打印字符 (粗略判斷)
  }
});

3. 物理鍵位不受佈局影響:e.code

// e.code 表示鍵盤物理位置,如 'KeyA', 'Digit1', 'ArrowLeft', 'ControlLeft'
document.addEventListener('keydown', e => {
  if (e.code === 'Space') { /* 空格鍵,無論輸入法狀態 */ }
});

4. 組合鍵檢測只能用 keydown/keyup

document.addEventListener('keydown', e => {
  if (e.ctrlKey && e.key === 's') {
    e.preventDefault(); // 阻止瀏覽器保存
    saveDocument();
  }
});

實戰選擇指南

需求推薦事件理由
表單輸入過濾/統計字符keypress / beforeinput (新標準)直接獲取將輸入的字符
快捷鍵 (Ctrl+S, Ctrl+Z...)keydown捕獲組合鍵、非字符鍵、可防默認
遊戲移動控制 (長按移動)keydown + keyup 維護按鍵狀態表長按 keydown 重複觸發,keyup 重置
輸入法組合輸入compositionstart/update/endkeypress/keydown 在組合期間行為不一
通用鍵盤日誌/調試keydown捕獲所有按鍵,含修飾鍵

現代最佳實踐:統一用 keydown + e.key/e.code

function handleKey(e) {
  switch (e.key) {
    case 'Enter': submit(); break;
    case 'Escape': closeModal(); break;
    case 'ArrowLeft': move(-1); break;
    case 'ArrowRight': move(1); break;
    default:
      if (e.key.length === 1 && !e.ctrlKey && !e.altKey && !e.metaKey) {
        typeCharacter(e.key); // 普通字符
      }
  }
}
document.addEventListener('keydown', handleKey);

避坑提示

  • keypress 已棄用** (MDN 標記 Deprecated),新項目勿用,改用 beforeinput 或 keydown + e.key。
  • 不要用 keyCode/which/charCode,已棄用,數值含義混亂 (如 keyCode=65 同時代表 'A' 和 'a')。
  • 輸入法編輯中 (IME):keydown 會觸發但 e.key 為 'Process' 或 'Dead',需配合 compositionstart/end 處理中文/日文輸入。
  • 自動重複:長按字符鍵會連續觸發 keydown + keypress,遊戲需用 Set 記錄按下狀態而非依賴事件頻率。
copyright © 萬盛學電腦網 all rights reserved