在此页

• 特性
• 方法
• 范例
• 规范
• 浏览器兼容性
• 相关话题

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

键盘 接口的 Keyboard API provides functions that retrieve keyboard layout maps and toggle capturing of key presses from the physical keyboard.

A list of valid code values is found in the UI Events KeyboardEvent code Values spec.

特性

None.

方法

Keyboard.getLayoutMap()

返回 Promise that resolves with an instance of KeyboardLayoutMap which is a map-like object with functions for retrieving the strings associated with specific physical keys.

Keyboard.lock()

返回 Promise after enabling the capture of keypresses for any or all of the keys on the physical keyboard.

Keyboard.unlock()

Unlocks all keys captured by the lock() method and returns synchronously.

范例

The following example demonstrates how to get the location- or layout-specific string associated with the key that corresponds to the 'W' key on an English QWERTY keyboard.

if (navigator.keyboard) {
  var keyboard = navigator.keyboard;
  keyboard.getLayoutMap()
  .then(keyboardLayoutMap => {
    var upKey = keyboardLayoutMap.get('KeyW');
    window.alert('Press ' + upKey + ' to move up.');
  });
} else {
  // Do something else.
}
					

规范

规范	状态	注释
Keyboard Map The definition of 'Keyboard' in that specification.	编者草案	初始定义。
Keyboard Lock The definition of 'Keyboard' in that specification.	编者草案	添加 lock() and unlock() .

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
键盘	Chrome 68	Edge 79	Firefox No	IE No	Opera 55	Safari No	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
getLayoutMap	Chrome 69	Edge 79	Firefox No	IE No	Opera 56	Safari No	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
lock	Chrome 68	Edge 79	Firefox No	IE No	Opera 55	Safari No	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
unlock	Chrome 68	Edge 79	Firefox No	IE No	Opera 55	Safari No	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

元数据

• 最后修改： Jul 12, 2019

相关话题

1. 键盘
2. 方法

   1. getLayoutMap()
   2. lock()
   3. unlock()