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)”。