Keyboard: Methode getLayoutMap()

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die getLayoutMap()-Methode der Keyboard-Schnittstelle gibt ein Promise zurück, das mit einer Instanz von KeyboardLayoutMap aufgelöst wird. Diese ist ein objektähnliches Mapping mit Funktionen zum Abrufen der Zeichenfolgen, die bestimmten physischen Tasten zugeordnet sind.

Syntax

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 der locations- oder layoutspezifische String abgerufen wird, der der Taste entspricht, die auf einer englischen QWERTY-Tastatur der Taste 'W' entspricht.

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

BCD tables only load in the browser

Siehe auch

Intl