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.isComposingKeyboardEvent описва събития от клавиатурата, например 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}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.