KeyboardEvent: свойство location

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Чтение только свойство KeyboardEvent.location возвращает значение unsigned long, представляющее расположение клавиши на клавиатуре или другом устройстве ввода.

Возможные значения:

Константа	Значение	Описание
`DOM_KEY_LOCATION_STANDARD`	0	Клавиша имеет только одну версию или не может быть отличена от левой и правой версии, и не была нажата на цифровой клавиатуре или клавише, которая считается частью клавиатуры.
`DOM_KEY_LOCATION_LEFT`	1	Клавиша была левой версией клавиши; например, была нажата левая клавиша `Control` на стандартной 101-клавишной американской клавиатуре. Это значение используется только для клавиш, которые имеют более одного возможного расположения на клавиатуре.
`DOM_KEY_LOCATION_RIGHT`	2	Клавиша была правой версией клавиши; например, нажата правая клавиша `Control` на стандартной 101-клавишной американской клавиатуре. Это значение используется только для клавиш, которые имеют более одного возможного расположения на клавиатуре.
`DOM_KEY_LOCATION_NUMPAD`	3	Клавиша находилась на цифровой клавиатуре или имеет виртуальный код клавиши, соответствующий цифровой клавиатуре. Примечание: Когда `NumLock` заблокирована, Firefox всегда возвращает `DOM_KEY_LOCATION_NUMPAD` для клавиш на цифровой клавиатуре. В противном случае, когда `NumLock` разблокирована и клавиатура фактически имеет цифровую клавиатуру, Firefox всегда возвращает `DOM_KEY_LOCATION_NUMPAD` тоже. С другой стороны, если у клавиатуры нет цифровой клавиатуры, например, на ноутбуке, некоторые клавиши становятся клавишами цифровой клавиатуры только при заблокированном NumLock. Когда такие клавиши генерируют события нажатия клавиш, значение атрибута location зависит от клавиши. То есть, оно не должно быть `DOM_KEY_LOCATION_NUMPAD`. Примечание: События нажатия клавиши для клавиши `NumLock` указывают на `DOM_KEY_LOCATION_STANDARD` как в Firefox, так и в Internet Explorer.
`DOM_KEY_LOCATION_MOBILE` Нестандартный Устаревший	4	Клавиша находилась на мобильном устройстве; это может быть на физической клавиатуре или виртуальной клавиатуре.
`DOM_KEY_LOCATION_JOYSTICK` Нестандартный Устаревший	5	Клавиша была кнопкой на контроллере для игр или джойстиком на мобильном устройстве.

Значение

Число.

Примеры

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

Спецификации

Спецификация
События пользовательского интерфейса # dom-keyboardevent-location

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`location`	30	12	15	17	8	30	15	18	8	2.0	4.4

См. также

KeyboardEvent

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/location