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.
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 vonKeyboardLayoutMap
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.
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:
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