键盘 API

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

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

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

if (navigator.keyboard) {
  const keyboard = navigator.keyboard;
  keyboard.getLayoutMap().then((keyboardLayoutMap) => {
    const upKey = keyboardLayoutMap.get("KeyW");
    window.alert(`Press ${upKey} to move up.`);
  });
} else {
  // Do something 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 实验性

一个类似于映射的对象，其中包含用于检索与特定物理键关联的字符串的功能。

navigator.keyboard 只读 实验性

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