База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Полета на KeyboardEvent: значение, позиция и състояние на клавиша

Разграничавайте стойността на клавиша от физическата му позиция и проверявайте повторението, състоянието на Shift и композирането на текст. Тези полета на KeyboardEvent помагат при обработката на клавишни комбинации, без да се бъркат клавиатурната подредба и въведеният текст.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.key; event.code; event.repeat; event.shiftKey; event.isComposing

KeyboardEvent описва събития от клавиатурата, например keydown и keyup. Петте свойства, разгледани тук (key, code, repeat, shiftKey и isComposing), са само за четене, но някои свойства, наследени от Event, като cancelBubble, позволяват и запис. KeyboardEvent.key е низ, който указва значението на клавиша с отчитане на подредбата и модификаторите, например "z", "Z" или "Enter". KeyboardEvent.code е низ, който идентифицира физическата позиция на клавиша независимо от подредбата: на клавиатура QWERTZ "KeyY" може да се появи заедно с key: "Z". Използвайте key за значението на клавиша, а code за управление според позицията.

KeyboardEvent.repeat е булева стойност: true означава автоматично повторение на задържан клавиш, а не брой повторения. В обработчик keydown изразът if (event.repeat) return; може да пропуска повтарящите се действия. KeyboardEvent.shiftKey указва дали Shift е бил активен в момента на събитието; това не означава, че самото събитие се отнася до Shift. При натискане на клавиш Shift (keydown) стойността е true; при отпускането му (keyup) тя може да остане true, ако другият клавиш Shift все още е натиснат.

KeyboardEvent.isComposing е булева стойност, която указва събитие между compositionstart и compositionend, например по време на композиция на текст с IME. Пропускането на клавишните комбинации, когато стойността е true, намалява намесата в композицията, но не открива всички гранични случаи при IME: в началото или края на композицията може да е false. Събитията от клавиатурата не заместват събитието input за проследяване на промените в текста.

Това са браузърни Web API, а не функции на конкретно издание на ECMAScript; Node 24 в хранилището не доказва наличността им. Проверете съвместимостта на всяко свойство с целевите браузъри; MDN обозначава repeat като Baseline 2025, което не гарантира поддръжка в по-стари версии. Примерът създава синтетично събитие с изрично зададени стойности: проверява достъпа до полетата, а не реални натискания на клавиши или поведението на IME.

Примери

(() => {
  const event = new KeyboardEvent("keydown", {
    key: "Z",
    code: "KeyY",
    repeat: true,
    shiftKey: true,
    isComposing: false
  });

  const { key, code, repeat, shiftKey, isComposing } = event;
  console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();

Резултат

{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници