Keyboard API
Keyboard API 的 KeyboardLayoutMap 接口是一个只读对象,具有检索与特定物理按键关联的字符串的功能。
KeyboardLayoutMap 实例是一个只读的类 Map 对象,其中每个按键都是一个字符串,用于标识键盘上唯一的物理按键(“按键代码”),相应的值是关联的按键属性值(可能受键盘布局等影响)。
在 UI 事件 KeyboardEvent 代码值规范中可以找到有效按键的列表。
实例属性
- KeyboardLayoutMap.size
- : 返回
KeyboardLayoutMap对象中的元素数量。
- : 返回
实例方法
KeyboardLayoutMap[Symbol.iterator]()- : 返回一个包含键/值对的新 Iterator 对象。
- KeyboardLayoutMap.entries()
- : 返回一个包含键/值对的新 Iterator 对象。
- KeyboardLayoutMap.forEach()
- : 为
KeyboardLayoutMap的每个元素执行一次提供的函数。
- : 为
- KeyboardLayoutMap.get()
- : 从
KeyboardLayoutMap对象返回具有给定键的元素。
- : 从
- KeyboardLayoutMap.has()
- : 返回一个布尔值,指示
KeyboardLayoutMap对象是否具有带指定键的元素。
- : 返回一个布尔值,指示
- KeyboardLayoutMap.keys()
- : 返回一个新的 Iterator 对象,该对象包含
KeyboardLayoutMap对象中每个索引的键。
- : 返回一个新的 Iterator 对象,该对象包含
- KeyboardLayoutMap.values()
- : 返回一个新的 Iterator 对象,该对象包含
KeyboardLayoutMap对象中每个索引的值。
- : 返回一个新的 Iterator 对象,该对象包含
示例
以下示例说明如何获取与英语 QWERTY 键盘上“W”键对应的键盘代码关联的位置或布局特定字符串。
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
const upKey = keyboardLayoutMap.get("KeyW");
window.alert(`按 ${upKey} 向上移动。`);
});
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
