Keyboard API
Keyboard API 的 Keyboard 接口提供检索键盘布局图和切换从物理键盘捕获按键的功能。
在 UI 事件 KeyboardEvent 代码值规范中可以找到有效的代码值列表。
实例属性
还从其父接口 EventTarget 继承属性。
实例方法
还从其父接口 EventTarget 继承方法。
- Keyboard.getLayoutMap()
- : 返回一个 Promise,兑现 KeyboardLayoutMap 实例,该实例是一个类 map 对象,具有检索与特定物理键关联的字符串的功能。
- Keyboard.lock()
- : 返回一个 Promise,在启用对物理键盘上任意或所有按键的按键捕获后兑现。
- Keyboard.unlock()
- : 解锁
lock()方法捕获的所有键并同步返回。
- : 解锁
示例
键盘映射
下面的示例说明如何获取与英语 QWERTY 键盘上“W”键对应的键关联的位置或布局特定字符串。
if (navigator.keyboard) {
const keyboard = navigator.keyboard;
keyboard.getLayoutMap().then((keyboardLayoutMap) => {
const upKey = keyboardLayoutMap.get("KeyW");
window.alert(`按 ${upKey} 向上移动。`);
});
} else {
// 做点别的事。
}
键盘锁定
以下示例捕获 <kbd>W</kbd>、<kbd>A</kbd>、<kbd>S</kbd> 和 <kbd>D</kbd> 键,并使用包含每个键的键代码属性值的列表调用 lock():
navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);
无论按键时使用了哪些修饰键,此操作都会捕获这些键。假设采用标准的美国 QWERTY 布局,注册 KeyW 可确保 <kbd>W</kbd>、<kbd>Shift+W</kbd>、<kbd>Control+W</kbd>、<kbd>Control+Shift+W</kbd> 以及所有其他带有 <kbd>W</kbd> 的修饰键组合都发送到应用。这同样适用于 KeyA、KeyS 和 KeyD。
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
