Keyboard:getLayoutMap() 方法

Limited availability

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

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

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

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

语法

js
getLayoutMap()

参数

无。

返回值

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

异常

SecurityError DOMException

如果调用被权限策略阻止,则抛出此异常。

示例

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

js
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

参见