KeyboardEvent: location Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die schreibgeschützte Eigenschaft KeyboardEvent.location gibt ein unsigned long zurück, das den Ort der Taste auf der Tastatur oder einem anderen Eingabegerät darstellt.

Mögliche Werte sind:

Konstante Wert Beschreibung
DOM_KEY_LOCATION_STANDARD 0 Die Taste hat nur eine Version oder kann nicht zwischen der linken und rechten Version unterschieden werden und wurde nicht auf dem Nummernblock oder einer Taste, die als Teil des Nummernblocks betrachtet wird, gedrückt.
DOM_KEY_LOCATION_LEFT 1 Die Taste war die linke Version der Taste; zum Beispiel wurde die linke Control-Taste auf einer Standard-Tastatur mit 101 Tasten in den USA gedrückt. Dieser Wert wird nur für Tasten verwendet, die mehr als eine mögliche Position auf der Tastatur haben.
DOM_KEY_LOCATION_RIGHT 2 Die Taste war die rechte Version der Taste; zum Beispiel wird die rechte Control-Taste auf einer Standard-Tastatur mit 101 Tasten in den USA gedrückt. Dieser Wert wird nur für Tasten verwendet, die mehr als eine mögliche Position auf der Tastatur haben.
DOM_KEY_LOCATION_NUMPAD 3

Die Taste war auf dem Nummernblock oder hat einen virtuellen Tastencode, der dem Nummernblock entspricht.

Hinweis: Wenn NumLock aktiviert ist, gibt Firefox immer DOM_KEY_LOCATION_NUMPAD für die Tasten auf dem Nummernblock zurück. Anderenfalls, wenn NumLock deaktiviert ist und die Tastatur tatsächlich einen Nummernblock hat, gibt Firefox ebenfalls immer DOM_KEY_LOCATION_NUMPAD zurück. Auf der anderen Seite, wenn die Tastatur keinen Nummernblock hat, wie zum Beispiel bei einem Notebook, werden einige Tasten nur dann zum Nummernblock, wenn NumLock aktiviert ist. Wenn solche Tasten Ereignisse auslösen, hängt der location-Attributwert von der Taste ab. Das heißt, es darf nicht DOM_KEY_LOCATION_NUMPAD sein.

Hinweis: Die Tastenereignisse der NumLock-Taste zeigen sowohl in Firefox als auch in Internet Explorer DOM_KEY_LOCATION_STANDARD an.

DOM_KEY_LOCATION_MOBILE Nicht standardisiert Veraltet 4

Die Taste war auf einem mobilen Gerät; dies kann entweder auf einem physischen Tastenfeld oder einer virtuellen Tastatur sein.

DOM_KEY_LOCATION_JOYSTICK Nicht standardisiert Veraltet 5

Die Taste war eine Taste auf einem Gamecontroller oder einem Joystick auf einem mobilen Gerät.

Wert

Eine Zahl.

Beispiele

js
function keyEvent(event) {
  console.log(`Location of key pressed: ${event.location}`);
}

Spezifikationen

Specification
UI Events
# dom-keyboardevent-location

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch