KeyboardEvent：keyCode 屬性

keyCode 的值

標準位置的可列印按鍵

在標準位置按壓或釋放可列印按鍵導致的按鍵事件值在不同瀏覽器之間不相容。

IE 只將原生虛擬按鍵程式碼值作為 KeyboardEvent.keyCode 暴露。

Google Chrome、Chromium 和 Safari 必須根據輸入的字元來決定值。如果輸入的字元可以透過美國鍵盤佈局輸入，它們會使用美國鍵盤佈局上的 keyCode 值。

Firefox 從按鍵輸入的 ASCII 字元獲取 keyCode 值，即使有 Shift 修飾鍵或 ASCII 相容的鍵盤佈局。詳情請參閱以下規則：

1. 如果系統是 Windows 且按下按鍵的原生按鍵程式碼指示該鍵是 a-z 或 0-9，則為其使用按鍵程式碼。
2. 如果系統是 Mac 且按下按鍵的原生按鍵程式碼指示該鍵是 0-9，則為其使用按鍵程式碼。
3. 如果按下的鍵在沒有修飾鍵的情況下輸入 ASCII 字母或數字字元，則為其使用按鍵程式碼。
4. 如果按下的鍵在按下 Shift 鍵修飾符的情況下輸入 ASCII 字母或數字字元，則為其使用按鍵程式碼。
5. 如果按下的鍵在沒有修飾鍵的情況下輸入不同的 ASCII 字元，則為其使用按鍵程式碼。
6. 如果按下的鍵在按下 Shift 鍵修飾符的情況下輸入不同的 ASCII 字元，則為其使用按鍵程式碼。
7. 否則，即按下的鍵輸入 Unicode 字元
   1. 如果鍵盤佈局是 ASCII 相容的（即可以輸入 ASCII 字母），則使用 0 或根據以下附加規則進行計算。
   2. 否則，即鍵盤佈局不是 ASCII 相容的，使用環境中優先順序最高的 ASCII 相容鍵盤佈局
      1. 如果備用鍵盤佈局上按下的鍵輸入 ASCII 字母或數字字元，則為其使用按鍵程式碼。
      2. 否則，使用 0 或根據以下附加規則進行計算。

Gecko 儘可能地（當達到上述列表中的第 7.1 或 7.2 點時）根據以下規則設定標點符號鍵的 keyCode 值

1. 如果執行 macOS 或 Linux

   1. 如果活動鍵盤佈局不是 ASCII 相容的，並且存在備用 ASCII 相容鍵盤佈局。

      1. 如果備用 ASCII 相容鍵盤佈局僅透過未修改的鍵產生 ASCII 字元，則使用該字元的 keyCode。
      2. 如果備用 ASCII 相容鍵盤佈局在按下 Shift 鍵時產生 ASCII 字元，則使用該 Shift 字元的 keyCode。
      3. 否則，當美國鍵盤佈局處於活動狀態時，使用該鍵產生的 ASCII 字元的 keyCode。

   2. 否則，當美國鍵盤佈局處於活動狀態時，使用該鍵產生的 ASCII 字元的 keyCode。

2. 如果執行在 Windows 上

   1. 當美國鍵盤佈局處於活動狀態時，使用對映到相同 Windows 虛擬鍵程式碼的鍵所產生的 ASCII 字元的 keyCode 值。

[1] 該值從 JIS 鍵盤輸入。當您使用 ANSI 鍵盤時，keyCode 值和輸入的字元與您從美國鍵盤佈局中選擇的相同。

[2] 該鍵是一個死鍵。keyup 事件的值為 0xBA (186)。

[3] 該鍵是一個死鍵。keyup 事件的值為 0x10 (16)。

[4] 未觸發任何按鍵事件。

[5] 該鍵在希臘語鍵盤佈局中不可用（不輸入任何字元）。keyup 事件的值為 0x00 (0)。

不可列印的鍵（功能鍵）

[1] 在 Windows 上，按 AltGraph 鍵會同時觸發 "ControlLeft" 和 "AltRight" 鍵事件。

[2] 當日文鍵盤佈局處於活動狀態時，不按 Shift 鍵而按 CapsLock 鍵會產生 0xF0 (240)。該鍵作為標籤為 "英數" 的 字母數字 鍵工作。

[3] 當日文鍵盤佈局處於活動狀態時，不按 Shift 鍵而按 "CapsLock" 鍵會產生 0x00 (0)。該鍵作為標籤為 "英數" 的 "字母數字" 鍵工作。

[1] 觸發了一個 keypress 事件，其 keyCode 和 charCode 為 0x10 (16)，但文字實際上並未輸入到編輯器中。

[2] 在 Mac 上，Help 鍵對映到 PC 鍵盤的 Insert 鍵。這些 keyCode 值與 Insert 鍵的 keyCode 值相同。

[3] 在 Fedora 20 上測試。

[4] 僅觸發 keyup 事件。

[5] PC 的 PrintScreen、ScrollLock 和 Pause 分別對映到 Mac 的 F13、F14 和 F15。Chrome 和 Safari 將它們對映到與 Mac 鍵相同的 keyCode 值。

[6] Pause 鍵與 Control 鍵結合會生成 0x03 (3)。

[1] 在 Fedora 20 上測試。

[2] 在 PC 上，PrintScreen、ScrollLock 和 Pause 分別對映到 Mac 的 F13、F14 和 F15。Firefox 為它們設定了與 PC 鍵相同的 keyCode 值。

[3] 在 Fedora 20 上測試。這些鍵不會導致 GDK_Fxx 鍵符號。如果這些鍵導致正確的鍵符號，這些值必須與 IE 相同。

[4] 在 Fedora 20 上測試。這些鍵在 Chromium 上不會導致 DOM 鍵事件。

[5] keyUp 事件的 keyCode 值為 0x83 (131)。

[6] 在 Fedora 20 上測試。這些鍵在 Firefox 上不會導致 DOM 鍵事件。

[7] 僅觸發 keydown 事件。

[8] Firefox 上未觸發任何 DOM 鍵事件。

數字鍵盤鍵

[1] "NumLock" 鍵在 Mac 上作為 "Clear" 鍵工作。

keyCode 值的常量

Gecko 在 KeyboardEvent 中定義了許多 keyCode 值，以便明確對映表。這些值對 Firefox 的附加元件開發者很有用，但在公共網頁中並不那麼有用。

示例

window.addEventListener("keydown", (event) => {
  if (event.defaultPrevented) {
    return; // Should do nothing if the default action has been cancelled
  }

  let handled = false;
  if (event.key !== undefined) {
    // Handle the event with KeyboardEvent.key
    handled = true;
  } else if (event.keyCode !== undefined) {
    // Handle the event with KeyboardEvent.keyCode
    handled = true;
  }

  if (handled) {
    // Suppress "double action" if event handled
    event.preventDefault();
  }
});

規範

瀏覽器相容性

Windows 上的 OEM 特定鍵

在 Windows 上，虛擬鍵碼的一些值是為 OEM 特定鍵定義（保留）的。它們可用於非標準鍵盤上的特殊鍵。換句話說，有些值被兩個或更多供應商（或硬體）用於不同的含義。

從 Gecko 21（以及早於 15 的版本）開始，OEM 特定鍵值僅在 Windows 上的 keyCode 屬性中可用。因此，它們對於通常的 Web 應用程式沒有用。它們僅適用於內部網應用程式或類似情況。

有關詳細資訊，請參閱 MSDN 中“製造商特定虛擬鍵碼 (Windows CE 5.0)”。