键盘 API

在物理键盘上，code 属性包含所按下按键的物理位置，key 属性包含按下键盘上该物理位置的按键所生成的字符串。key 值考虑了键盘的区域设置（例如“en-US”）、布局（例如“QWERTY”）和修饰键状态（Shift、Control 等）。过去没有办法检索这些信息。

键盘映射 API 提供了一种通过 Keyboard 接口和 KeyboardLayoutMap 接口检索特定按键所生成的字符串的方法。可以通过 navigator.keyboard 属性访问 Keyboard 接口。Keyboard 接口提供 Keyboard.getLayoutMap 方法，该方法返回一个 promise，其兑现一个 KeyboardLayoutMap 对象，该对象包含用于将代码转换为键的成员。有效代码值列表可在 UI 事件 KeyboardEvent 代码值规范的写入系统键部分中找到。

以下示例演示如何获取与英语 QWERTY 键盘上标记为 W 的键相关联的位置特定或布局特定字符串。

if (navigator.keyboard) {
  const keyboard = navigator.keyboard;
  keyboard.getLayoutMap().then((keyboardLayoutMap) => {
    const upKey = keyboardLayoutMap.get("KeyW");
    window.alert(`按 ${upKey} 向上移动。`);
  });
} else {
  // 做点别的事。
}

丰富的交互式网页、游戏和远程流媒体体验通常需要在全屏模式下访问特殊键和键盘快捷键。此类键/键组合的示例包括 Escape、Alt+Tab 和 Ctrl+N。这些键和键组合通常由用户代理或底层操作系统捕获，如下例所示。

要捕获 W、A、S 和 D 键，请使用包含每个键的键代码属性值的列表调用 lock()：

navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);

无论按键时使用哪种修饰符，此操作都会捕获这些键。假设采用标准的美国 QWERTY 布局，注册 KeyW 可确保 W、Shift+W、Control+W、Control+Shift+W 以及所有其他带有 W 的键修饰符组合都发送到应用。这同样适用于 KeyA、KeyS 和 KeyD。

传递给 Keyboard.lock 的代码和 KeyboardLayoutMap 接口的各种方法称为“写入系统键”。

“写入系统键”在 UI 事件 KeyboardEvent 代码值规范的写入系统键部分中定义，因为物理键会根据当前语言环境和键盘布局改变含义。这些键如下所示。所有标准键盘上都有蓝色键，而绿色键仅在某些键盘上可用。

Keyboard 实验性

提供检索键盘布局图和从物理键盘切换捕获按键的功能。

KeyboardLayoutMap 实验性

一个类 map 的对象，具有检索与特定物理键关联的字符串的功能。

navigator.keyboard 只读 实验性

返回一个 Keyboard 对象，该对象提供对检索键盘布局图和从物理键盘切换按键捕获的功能的访问。