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.

EventTarget Keyboard

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 von KeyboardLayoutMap 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.

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 W-, A-, S- und D-Tasten, indem lock() mit einer Liste aufgerufen wird, die den Schlüsselcodeattributwert 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. 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

Browser-Kompatibilität