键盘:getLayoutMap() 方法

可用性有限

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

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

安全上下文: 仅在 安全上下文 (HTTPS) 中,在一些或所有 支持的浏览器 中,才能使用此功能。

getLayoutMap() 方法是 Keyboard 接口的方法,它返回一个 Promise,该承诺将解析为 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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅