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
Promisethat resolves with an instance ofKeyboardLayoutMap(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
Promiseafter 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