Свойство клавиши KeyboardEvent

❮ Предыдущий Справочник по событиям Далее ❯

Пример

Получить кнопку клавиатуры, которая была нажата, когда произошло ключевое событие:

var x = event.key;

Другие примеры «Попробуйте сами» ниже.

Определение и использование

Свойство key возвращает идентификатор клавиши, которая была нажата при возникновении ключевого события.

Идентификаторы клавиш — это строки, идентифицирующие кнопки клавиатуры. Возвращаемое значение этого свойства может быть строкой:

Один символ (например, «a», «W», «4», «+» или «$»)
Многосимвольный (например, «F1», «Enter», «HOME» или «CAPS LOCK»)

Примечание. Это свойство доступно только для чтения.

Совет: Если вы хотите узнать, была ли нажата клавиша «ALT», «CTRL», «META» или «SHIFT» при возникновении события клавиши, используйте свойство altKey , ctrlKey , metaKey или shiftKey .

Поддержка браузера

Цифры в таблице указывают на первую версию браузера, которая полностью поддерживает это свойство.

Property
key	51.0	9.0	23.0	10.0	38.0

Синтаксис

event.key

Технические детали

Возвращаемое значение:	Строка, представляющая нажатую кнопку клавиатуры. Возможные значения: Один символ (например, «a», «W», «4», «+» или «$») Многосимвольный (например, «F1», «Enter», «HOME» или «CAPS LOCK») Примечание. В Safari возвращает неопределенное значение .
Версия ДОМ:	События DOM уровня 3

Возвращаемое значение:

Строка, представляющая нажатую кнопку клавиатуры.

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

Один символ (например, «a», «W», «4», «+» или «$»)
Многосимвольный (например, «F1», «Enter», «HOME» или «CAPS LOCK»)

Примечание. В Safari возвращает неопределенное значение .

Версия ДОМ:

События DOM уровня 3

Дополнительные примеры

Пример

Предупреждать некоторый текст, если пользователь нажимает клавишу «A»:

var x = event.key;

// If the pressed keyboard button is "a" or "A" (using caps lock or shift), alert some text.

if (x == "a" || x == "A") {
alert ("You pressed the 'A' key!");
}