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 vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das Keyboard
-Interface der Keyboard API bietet Funktionen zum Abrufen von Tastaturlayout-Karten und zum Umschalten der Erfassung von Tastenanschlägen von der physischen Tastatur.
Eine Liste gültiger Codewerte finden Sie in der Spezifikation zu UI Events KeyboardEvent code Values.
Instanzeigenschaften
Erbt auch Eigenschaften von seiner übergeordneten Schnittstelle, EventTarget
.
Instanzmethoden
Erbt auch Methoden von seiner übergeordneten Schnittstelle, EventTarget
.
Keyboard.getLayoutMap()
Experimentell-
Gibt ein
Promise
zurück, das mit einer Instanz vonKeyboardLayoutMap
aufgelöst wird, einem kartenähnlichen Objekt mit Funktionen zum Abrufen der mit bestimmten physischen Tasten verbundenen Strings. Keyboard.lock()
Experimentell-
Gibt ein
Promise
zurück, das aufgelöst wird, nachdem die Erfassung von Tastenanschlägen für eine oder alle Tasten auf der physischen Tastatur aktiviert wurde. Keyboard.unlock()
Experimentell-
Entsperrt alle durch die
lock()
-Methode erfassten Tasten und gibt synchron zurück.
Beispiel
Tastaturzuordnung
Das folgende Beispiel zeigt, wie der standort- oder layout-spezifische String abgerufen wird, 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 W-, A-, S- und D-Tasten, indem lock()
mit einer Liste aufgerufen wird, die den Schlüsselcodeattributwert 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, es handelt sich um ein standardmäßiges US-QWERTY-Layout, stellt die Registrierung von KeyW
sicher, dass W, Shift+W, Control+W, Control+Shift+W und alle anderen Schlüsselmodifikator-Kombinationen mit W an die App gesendet werden. Dasselbe gilt für KeyA
, KeyS
und KeyD
.
Spezifikationen
Specification |
---|
Keyboard Map # keyboard-interface |
Keyboard Lock # keyboard-interface |