Keyboard: getLayoutMap() Methode

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.

Die getLayoutMap() Methode des Keyboard Interfaces gibt ein Promise zurück, das mit einer Instanz von KeyboardLayoutMap aufgelöst wird. Diese ist ein map-ähnliches Objekt mit Funktionen zum Abrufen der Zeichenfolgen, die mit bestimmten physischen Tasten verknüpft sind.

Syntax

js
getLayoutMap()

Parameter

Keine.

Rückgabewert

Ein Promise das mit einer Instanz von KeyboardLayoutMap aufgelöst wird.

Ausnahmen

SecurityError DOMException

Wird ausgelöst, wenn der Aufruf durch eine Berechtigungsrichtlinie blockiert wird.

Beispiele

Das folgende Beispiel zeigt, wie man die orts- oder layout-spezifische Zeichenfolge erhält, die der Taste entspricht, die auf einer englischen QWERTY-Tastatur der 'W'-Taste entspricht.

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

Spezifikationen

Specification
Keyboard Map
# h-keyboard-getlayoutmap

Browser-Kompatibilität

Siehe auch