此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

KeyboardLayoutMap

有限可用

此特性不属于基线,因为它尚未在主流浏览器中得到支持。

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

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”键对应的键盘代码关联的位置或布局特定字符串。

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

规范

规范
Keyboard Map
# keyboardlayoutmap

浏览器兼容性