KeyboardLayoutMap

可用性有限

此功能不是基线功能，因为它在一些最广泛使用的浏览器中无法正常工作。

实验性： 这是一个实验性技术
在生产环境中使用此功能之前，请仔细查看浏览器兼容性表。

KeyboardLayoutMap 是键盘 API 的一个只读对象，它包含用于检索与特定物理键关联的字符串的功能。

KeyboardLayoutMap 实例是一个只读的 Map 类对象，其中每个键都是一个字符串，用于标识键盘上的唯一物理键（“键码”），对应的值是关联的键属性值（这可能会受到键盘布局等因素的影响）。

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

实例属性

KeyboardLayoutMap.size 只读实验性: 返回 KeyboardLayoutMap 对象中元素的数量。

实例方法

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

示例

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

navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`Press ${upKey} to move up.`);
});

规范

规范
键盘映射 # keyboardlayoutmap-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。