Keyboard：getLayoutMap() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/zh-cn/web/api/keyboard_api/index.md)

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

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

Keyboard 接口的 getLayoutMap() 方法返回一个 Promise，其会兑现一个 KeyboardLayoutMap 实例，该实例是一个类 map 的对象，具有检索与特定物理键关联的字符串的功能。

语法

getLayoutMap()

参数

无。

返回值

一个 Promise，其会兑现一个 KeyboardLayoutMap 实例。

异常

SecurityError DOMException: 如果调用被权限策略阻止，则抛出此异常。

示例

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

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

规范

Specification
Keyboard Map # h-keyboard-getlayoutmap

浏览器兼容性

BCD tables only load in the browser

参见

Intl