Keyboard

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

The Keyboard interface of the the Keyboard API (en-US) 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.

Properties

None.

Methods

Keyboard.getLayoutMap() (en-US) 实验性

Returns a Promise that resolves with an instance of KeyboardLayoutMap (en-US) which is a map-like object with functions for retrieving the strings associated with specific physical keys.

Keyboard.lock() (en-US) 实验性

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

Keyboard.unlock() (en-US) 实验性

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

Example

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.

js

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.
}

Specifications

Specification
Keyboard Map
# keyboard-interface
Keyboard Lock
# keyboard-interface

Browser compatibility

BCD tables only load in the browser