大网数据广告活动
Web 标准与前端开发

Keyboard

· 52CE 我爱测

Keyboard API 的 **`Keyboard`** 接口提供检索键盘布局图和切换从物理键盘捕获按键的功能。

Keyboard API

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

在 UI 事件 KeyboardEvent 代码值规范中可以找到有效的代码值列表。

实例属性

还从其父接口 EventTarget 继承属性。

实例方法

还从其父接口 EventTarget 继承方法。

  • Keyboard.getLayoutMap()
    • : 返回一个 Promise,兑现 KeyboardLayoutMap 实例,该实例是一个类 map 对象,具有检索与特定物理键关联的字符串的功能。
  • Keyboard.lock()
    • : 返回一个 Promise,在启用对物理键盘上任意或所有按键的按键捕获后兑现。
  • Keyboard.unlock()
    • : 解锁 lock() 方法捕获的所有键并同步返回。

示例

键盘映射

下面的示例说明如何获取与英语 QWERTY 键盘上“W”键对应的键关联的位置或布局特定字符串。

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

键盘锁定

以下示例捕获 <kbd>W</kbd>、<kbd>A</kbd>、<kbd>S</kbd> 和 <kbd>D</kbd> 键,并使用包含每个键的键代码属性值的列表调用 lock():

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

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

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。