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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
location

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch