KeyboardLayoutMap

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

KeyboardLayoutMap 接口是 Keyboard API 的一部分,它是一个只读对象,提供用于检索与特定物理按键关联的字符串的函数。

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

有效键的列表可以在 UI Events KeyboardEvent code Values 规范中找到。

实例属性

KeyboardLayoutMap.size 只读 实验性

返回 KeyboardLayoutMap 对象中的元素数量。

实例方法

KeyboardLayoutMap[Symbol.iterator]() 实验性

返回一个包含键/值对的新 Iterator 对象。

KeyboardLayoutMap.entries() 实验性

返回一个包含键/值对的新 Iterator 对象。

KeyboardLayoutMap.forEach() 实验性

KeyboardLayoutMap 的每个元素执行一次提供的函数。

KeyboardLayoutMap.get() 实验性

KeyboardLayoutMap 对象中返回具有给定键的元素。

KeyboardLayoutMap.has() 实验性

返回一个布尔值,指示 KeyboardLayoutMap 对象是否具有指定键的元素。

KeyboardLayoutMap.keys() 实验性

返回一个包含 KeyboardLayoutMap 对象中每个索引的键的新 Iterator 对象。

KeyboardLayoutMap.values() 实验性

返回一个包含 KeyboardLayoutMap 对象中每个索引的值的新 Iterator 对象。

示例

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

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

规范

规范
键盘映射
# keyboardlayoutmap-interface

浏览器兼容性