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, bevor Sie diese produktiv verwenden.
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
Nur lesbar Experimentell-
Gibt die Anzahl der Elemente im
KeyboardLayoutMap
-Objekt zurück.
Instanz-Methoden
KeyboardLayoutMap[Symbol.iterator]()
Experimentell-
Gibt ein neues Iterator-Objekt zurück, das die Schlüssel/Wert-Paare enthält.
KeyboardLayoutMap.entries()
Experimentell-
Gibt ein neues Iterator-Objekt zurück, das die Schlüssel/Wert-Paare enthält.
KeyboardLayoutMap.forEach()
Experimentell-
Führt eine bereitgestellte Funktion einmal für jedes Element von
KeyboardLayoutMap
aus. KeyboardLayoutMap.get()
Experimentell-
Gibt das Element mit dem angegebenen Schlüssel aus dem
KeyboardLayoutMap
-Objekt zurück. KeyboardLayoutMap.has()
Experimentell-
Gibt einen Boolean zurück, der angibt, ob das
KeyboardLayoutMap
-Objekt ein Element mit dem angegebenen Schlüssel enthält. KeyboardLayoutMap.keys()
Experimentell-
Gibt ein neues Iterator-Objekt zurück, das die Schlüssel für jeden Index im
KeyboardLayoutMap
-Objekt enthält. KeyboardLayoutMap.values()
Experimentell-
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.
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