Клавиатура

Интерфейс Keyboard API клавиатуры предоставляет функции, которые извлекают карты раскладок клавиатуры и включают/выключают захват нажатий клавиш с физической клавиатуры.

Список допустимых значений кодов см. в спецификации UI Events KeyboardEvent code Values.

Также наследует свойства от своего родительского интерфейса EventTarget.

Также наследует методы от своего родительского интерфейса EventTarget.

Keyboard.getLayoutMap() Экспериментально

Возвращает Promise, который разрешается экземпляром KeyboardLayoutMap, который представляет собой объект типа "карта" с функциями для извлечения строк, связанных с определенными физическими клавишами.

Keyboard.lock() Экспериментально

Возвращает Promise, который разрешается после включения захвата нажатий клавиш для любой или всех клавиш на физической клавиатуре.

Keyboard.unlock() Экспериментально

Разблокирует все клавиши, захваченные методом lock(), и возвращает результат синхронно.

Следующий пример демонстрирует, как получить строку, специфичную для расположения или раскладки, связанную с клавишей, соответствующей клавише 'W' на английской клавиатуре QWERTY.

if (navigator.keyboard) {
  const keyboard = navigator.keyboard;
  keyboard.getLayoutMap().then((keyboardLayoutMap) => {
    const upKey = keyboardLayoutMap.get("KeyW");
    window.alert(`Press ${upKey} to move up.`);
  });
} else {
  // Do something else.
}

В следующем примере захватываются клавиши W, A, S и D, вызывая lock() со списком, содержащим значение атрибута кода клавиши для каждой из этих клавиш:

navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);

Это захватывает эти клавиши независимо от используемых модификаторов при нажатии. Предполагая стандартную раскладку QWERTY США, регистрация KeyW гарантирует, что W, Shift+W, Control+W, Control+Shift+W и все другие комбинации нажатий клавиш с W будут отправлены в приложение. То же самое относится к KeyA, KeyS, и KeyD.