Элемент: событие keypress

Событие keypress срабатывает при нажатии клавиши, которая генерирует символ.

Примеры клавиш, генерирующих символ, — это буквы, цифры и знаки препинания. Примеры клавиш, не генерирующих символ, — это модификационные клавиши, такие как Alt, Shift, Ctrl или Meta.

Используйте имя события в методах, таких как addEventListener(), или задайте обработчик события.

addEventListener("keypress", (event) => {});

onkeypress = (event) => {};

Объект KeyboardEvent. Наследуется от UIEvent и Event.

Этот интерфейс также наследует свойства своих родительских интерфейсов, UIEvent и Event.

KeyboardEvent.altKey Только для чтения

Возвращает логическое значение, равное true , если клавиша Alt (Option или ⌥ на macOS) была активна при возникновении события нажатия клавиши.

KeyboardEvent.code Только для чтения

Возвращает строку с кодовым значением физической клавиши, представленной событием.

KeyboardEvent.ctrlKey Только для чтения

Возвращает логическое значение, равное true , если клавиша Ctrl была активна при возникновении события нажатия клавиши.

KeyboardEvent.isComposing Только для чтения

Возвращает логическое значение, равное true , если событие срабатывает между compositionstart и compositionend.

KeyboardEvent.key Только для чтения

Возвращает строку, представляющую значение клавиши, представленной событием.

KeyboardEvent.location Только для чтения

Возвращает число, представляющее расположение клавиши на клавиатуре или другом устройстве ввода. Список констант, определяющих расположения, показан в разделе Расположения клавиш.

KeyboardEvent.metaKey Только для чтения

Возвращает логическое значение, равное true , если клавиша Meta (на клавиатурах Mac — клавиша ⌘ Command, на клавиатурах Windows — клавиша Windows (⊞)) была активна при возникновении события нажатия клавиши.

KeyboardEvent.repeat Только для чтения

Возвращает логическое значение, равное true , если клавиша удерживается и автоматически повторяется.

KeyboardEvent.shiftKey Только для чтения

Возвращает логическое значение, равное true , если клавиша Shift была активна при возникновении события нажатия клавиши.

В этом примере регистрируется значение KeyboardEvent.code каждый раз, когда вы нажимаете клавишу после фокусировки элемента <input>.

<div>
  <label for="sample">Focus the input and type something:</label>
  <input type="text" name="text" id="sample" />
</div>
<p id="log"></p>

const log = document.getElementById("log");
const input = document.querySelector("input");

input.addEventListener("keypress", logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

• Интерфейс Document, на который также направлено событие.

• Связанные события:

  • input
  • keydown
  • keyup