Keyboard: getLayoutMap() 方法

可用性有限

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

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

Keyboard 接口的 getLayoutMap() 方法返回一个 Promise,该 Promise 会解析为一个 KeyboardLayoutMap 实例。KeyboardLayoutMap 是一个类似映射的对象,提供了用于检索与特定物理键相关联的字符串的函数。

语法

js
getLayoutMap()

参数

无。

返回值

一个 Promise,它会解析为一个 KeyboardLayoutMap 实例。

异常

SecurityError DOMException

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

示例

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

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

规范

规范
键盘映射
# h-keyboard-getlayoutmap

浏览器兼容性

另见