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

KeyboardLayoutMap

· 52CE 我爱测

Keyboard API 的 **`KeyboardLayoutMap`** 接口是一个只读对象,具有检索与特定物理按键关联的字符串的功能。

Keyboard API

Keyboard API 的 KeyboardLayoutMap 接口是一个只读对象,具有检索与特定物理按键关联的字符串的功能。

KeyboardLayoutMap 实例是一个只读的类 Map 对象,其中每个按键都是一个字符串,用于标识键盘上唯一的物理按键(“按键代码”),相应的值是关联的按键属性值(可能受键盘布局等影响)。

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

实例属性

  • KeyboardLayoutMap.size
    • : 返回 KeyboardLayoutMap 对象中的元素数量。

实例方法

  • KeyboardLayoutMap[Symbol.iterator]()
    • : 返回一个包含键/值对的新 Iterator 对象。
  • KeyboardLayoutMap.entries()
    • : 返回一个包含键/值对的新 Iterator 对象。
  • KeyboardLayoutMap.forEach()
    • : 为 KeyboardLayoutMap 的每个元素执行一次提供的函数。
  • KeyboardLayoutMap.get()
    • : 从 KeyboardLayoutMap 对象返回具有给定键的元素。
  • KeyboardLayoutMap.has()
    • : 返回一个布尔值,指示 KeyboardLayoutMap 对象是否具有带指定键的元素。
  • KeyboardLayoutMap.keys()
    • : 返回一个新的 Iterator 对象,该对象包含 KeyboardLayoutMap 对象中每个索引的键。
  • KeyboardLayoutMap.values()
    • : 返回一个新的 Iterator 对象,该对象包含 KeyboardLayoutMap 对象中每个索引的值。

示例

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

navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`按 ${upKey} 向上移动。`);
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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