Keyboard

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

Keyboard interface of the the 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.
}
					

规范

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

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
Keyboard
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

图例

完整支持
完整支持
不支持
不支持
实验。期望将来行为有所改变。
实验。期望将来行为有所改变。