KeyboardEvent: location property
The KeyboardEvent.location
read-only property returns an
unsigned long
representing the location of the key on the keyboard or other
input device.
Possible values are:
Constant | Value | Description |
---|---|---|
DOM_KEY_LOCATION_STANDARD |
0 | The key has only one version, or can't be distinguished between the left and right versions of the key, and was not pressed on the numeric keypad or a key that is considered to be part of the keypad. |
DOM_KEY_LOCATION_LEFT |
1 | The key was the left-hand version of the key; for example, the left-hand Control key was pressed on a standard 101 key US keyboard. This value is only used for keys that have more than one possible location on the keyboard. |
DOM_KEY_LOCATION_RIGHT |
2 | The key was the right-hand version of the key; for example, the right-hand Control key is pressed on a standard 101 key US keyboard. This value is only used for keys that have more than one possible location on the keyboard. |
DOM_KEY_LOCATION_NUMPAD |
3 |
The key was on the numeric keypad, or has a virtual key code that corresponds to the numeric keypad.
Note: When NumLock is locked, Firefox
always returns
Note: NumLock key's key events indicate
|
DOM_KEY_LOCATION_MOBILE
Non-standard
Deprecated
|
4 |
The key was on a mobile device; this can be on either a physical keypad or a virtual keyboard. |
DOM_KEY_LOCATION_JOYSTICK
Non-standard
Deprecated
|
5 |
The key was a button on a game controller or a joystick on a mobile device. |
Value
A number.
Examples
js
function keyEvent(event) {
console.log(`Location of key pressed: ${event.location}`);
}
Specifications
Specification |
---|
UI Events # dom-keyboardevent-location |
Browser compatibility
BCD tables only load in the browser