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

CKTIS / JavaScript

KeyboardEvent.key — значението на клавиша

KeyboardEvent.key е свойство от тип низ, което е само за четене и описва значението на клавиша. То отчита клавиатурната подредба и модификаторите; за разлика от code, не описва физическото положение на клавиша.

Версия: 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

KeyboardEvent.key, прочетено като event.key, връща низ, описващ значението на клавиша. При печатаемите знаци то отчита клавиатурната подредба и модификаторите, например "a" или "A". Свойството е само за четене.

UI Events групира именуваните стойности на клавишите в различни категории: "Enter" е сред клавишите, свързани с празни знаци, "Escape" е сред клавишите за потребителския интерфейс, а "ArrowDown" е сред клавишите за навигация. Интервалът има стойност " ", а не "Space". "Dead" обозначава мъртъв клавиш, използван за съставяне на знаци, а "Unidentified" означава, че клавишът не е могъл да бъде идентифициран. Сравненията на низове различават малки и главни букви.

Използвайте key, когато значението на клавиша е важно, и code, когато е важно физическото му положение. Не приемайте клавиатурните събития за пълен запис на въвеждането на текст; за редактиране обмислете събитията beforeinput и input.

Това е браузърно Web API, дефинирано в UI Events, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 не доказва поддръжка. Примерът задава изрично key и code: конструкторът не изчислява key от code или shiftKey. Той проверява прочитането на стойностите, а не истинска клавиатура; поддръжката в целевите браузъри трябва да се провери отделно.

Примери

const events = [
  new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
  new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
  new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];

console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));

Резултат

a:KeyA
A:KeyA
Enter:Enter

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

Източници