Коды клавиш

Что показывает проверка клавиатуры

Инструмент показывает свойства события нажатия клавиши: значение key, физический код code, модификаторы, расположение и автоповтор. Значения можно скопировать по отдельности или посмотреть вместе в JSON события.

Чем key отличается от code

key описывает результат нажатия с учетом раскладки и модификаторов. code обозначает физическую позицию клавиши, например KeyA. При смене раскладки значение key может измениться, хотя физический code останется прежним.

Это различие нужно при проектировании горячих клавиш. Текстовое действие обычно связывают со значением, а управление по физическим позициям может опираться на code. Устаревший keyCode показывается для диагностики прежнего кода и не является предпочтительным основанием для новой обработки.

Модификатор и последовательность событий

Ctrl, Alt, Shift и Meta изменяют смысл некоторых сочетаний. Состояние модификатора в событии показывает, был ли он активен при конкретном keydown, а не полный журнал всех действий пользователя. Следующее событие может относиться уже к другой клавише при том же удерживаемом модификаторе.

Если клавиша удерживается, браузер может формировать повторные события с признаком repeat. Первое нажатие и последующие повторы поэтому полезно различать в обработчике горячих клавиш, чтобы не запускать одно действие многократно без необходимости.

Раскладка и составной ввод текста

Некоторые символы вводятся через последовательность действий, dead keys или редактор ввода IME. В такой ситуации отдельное событие клавиши не обязательно содержит весь окончательный текст, который пользователь получит в поле.

Поэтому для ввода текста нельзя во всех случаях собирать строку вручную только из keydown. События ввода и композиции решают другую задачу, чем диагностика физических и логических клавиш. На этой странице выводятся свойства полученного нажатия; она не показывает полный протокол композиции и не определяет язык всей будущей строки по одному code.

Как проверить сочетание

Поставьте курсор в «Поле для нажатий клавиш» и нажмите нужную клавишу или сочетание. Результат обновляется на событии keydown только для этого поля. Другие поля и весь сайт не прослушиваются как единый ввод клавиатуры.

Смотрите Ctrl, Alt, Shift и Meta в строке модификаторов. «Расположение» помогает различать левую, правую или цифровую часть там, где браузер сообщает эти сведения. «Автоповтор» показывает, сформировано ли событие удержанием клавиши.

Ограничения браузерной диагностики

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

Поэтому отсутствие события не доказывает аппаратную неисправность. Инструмент не измеряет электрические сигналы клавиатуры, задержку переключателя или полный набор одновременно удерживаемых клавиш. Он предназначен для разбора события, которое действительно получило поле браузера.