KeyboardLayoutMap

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.

Das KeyboardLayoutMap-Interface der Keyboard API ist ein schreibgeschütztes Objekt mit Funktionen zum Abrufen des Strings, der mit bestimmten physischen Tasten verknüpft ist.

Eine Instanz von KeyboardLayoutMap ist ein schreibgeschütztes Map-ähnliches Objekt, bei dem jeder Schlüssel ein String ist, der die eindeutige physische Taste auf der Tastatur identifiziert (ein "Key-Code"), und der entsprechende Wert ist der zugehörige Schlüsselattributwert (der durch das Tastaturlayout und andere Faktoren beeinflusst werden kann).

Eine Liste gültiger Schlüssel finden Sie in der Spezifikation der UI Events KeyboardEvent code Values.

Instanz-Eigenschaften

KeyboardLayoutMap.size Schreibgeschützt

Gibt die Anzahl der Elemente im KeyboardLayoutMap-Objekt zurück.

Instanz-Methoden

KeyboardLayoutMap[Symbol.iterator]()

Gibt ein neues Iterator-Objekt zurück, das die Schlüssel/Wert-Paare enthält.

KeyboardLayoutMap.entries()

Gibt ein neues Iterator-Objekt zurück, das die Schlüssel/Wert-Paare enthält.

KeyboardLayoutMap.forEach()

Führt eine bereitgestellte Funktion einmal für jedes Element von KeyboardLayoutMap aus.

KeyboardLayoutMap.get()

Gibt das Element mit dem angegebenen Schlüssel aus dem KeyboardLayoutMap-Objekt zurück.

KeyboardLayoutMap.has()

Gibt einen Boolean zurück, der angibt, ob das KeyboardLayoutMap-Objekt ein Element mit dem angegebenen Schlüssel enthält.

KeyboardLayoutMap.keys()

Gibt ein neues Iterator-Objekt zurück, das die Schlüssel für jeden Index im KeyboardLayoutMap-Objekt enthält.

KeyboardLayoutMap.values()

Gibt ein neues Iterator-Objekt zurück, das die Werte für jeden Index im KeyboardLayoutMap-Objekt enthält.

Beispiele

Das folgende Beispiel zeigt, wie der standort- oder layoutspezifische String abgerufen wird, der mit dem Tastencode übereinstimmt, der der Taste 'W' auf einer englischen QWERTY-Tastatur entspricht.

js
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`Press ${upKey} to move up.`);
});

Spezifikationen

Specification
Keyboard Map
# keyboardlayoutmap-interface

Browser-Kompatibilität

BCD tables only load in the browser