DieKeyboard-Schnittstelle derKeyboard API bietet Funktionen, die Tastaturlayout-Karten abrufen und das Erfassen von Tastendrücken von der physischen Tastatur umschalten.

Eine Liste gültiger Code-Werte finden Sie in der SpezifikationUI Events KeyboardEvent code Values.

Instanz-Eigenschaften

Erbt auch Eigenschaften von ihrer Elternschnittstelle,EventTarget.

Instanz-Methoden

Erbt auch Methoden von ihrer Elternschnittstelle,EventTarget.

Keyboard.getLayoutMap()Experimentell

Gibt einPromise zurück, das mit einer Instanz vonKeyboardLayoutMap aufgelöst wird, die ein Map-ähnliches Objekt mit Funktionen zum Abrufen der Strings ist, die mit bestimmten physischen Tasten verbunden sind.

Keyboard.lock()Experimentell

Gibt einPromise zurück, das sich auflöst, nachdem das Erfassen von Tastendrücken für eine oder alle Tasten auf der physischen Tastatur aktiviert wurde.

Keyboard.unlock()Experimentell

Entsperrt alle Tasten, die durch die Methodelock() erfasst wurden, und gibt synchron zurück.

Beispiel

Tastaturzuordnung

Das folgende Beispiel zeigt, wie man den orts- oder layoutspezifischen String erhält, der der Taste entspricht, die der 'W'-Taste auf einer englischen QWERTY-Tastatur entspricht.

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

Tastatursperre

Das folgende Beispiel erfasst die TastenW,A,S undD>, indemlock()` mit einer Liste aufgerufen wird, die den Schlüsselattributwert für jede dieser Tasten enthält:

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

Dies erfasst diese Tasten unabhängig davon, welche Modifikatoren mit dem Tastendruck verwendet werden. Angenommen, ein Standard-QWERTY-Layout der Vereinigten Staaten ist in Verwendung, stellt die RegistrierungKeyW sicher, dassW,Shift+W,Control+W,Control+Shift+W, und alle anderen Tastenmodifikator-Kombinationen mitW an die App gesendet werden. Das Gleiche gilt fürKeyA,KeyS undKeyD.

Spezifikationen

Browser-Kompatibilität