Keyboard

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

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

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

EventTarget Keyboard

Instanzeigenschaften

Erbt auch Eigenschaften von ihrer Elternschnittstelle, EventTarget.

Instanzmethoden

Erbt auch Methoden von ihrer Elternschnittstelle, EventTarget.

Keyboard.getLayoutMap() Experimentell

Gibt ein Promise zurück, das mit einer Instanz von KeyboardLayoutMap aufgelöst wird, welches ein kartenähnliches Objekt mit Funktionen zum Abrufen der mit bestimmten physischen Tasten verbundenen Zeichenfolgen ist.

Keyboard.lock() Experimentell

Gibt ein Promise zurück, das nach dem Aktivieren des Tastendruckerfassens für beliebige oder alle Tasten auf der physischen Tastatur aufgelöst wird.

Keyboard.unlock() Experimentell

Entsperrt alle von der lock()-Methode erfassten Tasten und gibt synchron zurück.

Beispiel

Tastaturzuordnung

Das folgende Beispiel demonstriert, wie Sie die standort- oder layoutspezifische Zeichenfolge abrufen, die der Taste entspricht, die auf einer englischen QWERTY-Tastatur der Taste 'W' entspricht.

js
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 Tasten W, A, S und D> und ruft lock() mit einer Liste auf, die den Schlüsselcode-Attributwert für jede dieser Tasten enthält:

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

Dies erfasst diese Tasten unabhängig davon, welche Modifikatoren mit dem Tastendruck verwendet werden. Bei einem Standard-Layout der Vereinigten Staaten QWERTY stellt das Registrieren von KeyW sicher, dass W, Shift+W, Control+W, Control+Shift+W und alle anderen Tastenkombinationen mit Modifikatoren für W an die App gesendet werden. Dasselbe gilt für KeyA, KeyS und KeyD.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser