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

CKTIS / JavaScript

KeyboardEvent.code — физически клавиш вместо символ

KeyboardEvent.code идентифицира физическата позиция на клавиша независимо от клавиатурната подредба и модификаторите. Научете как code се различава от key и кога въвеждането на текст и виртуалните клавиатури изискват различен подход.

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

Синтаксис

event.code

KeyboardEvent.code е свойство само за четене, което връща идентификатор на физически клавиш като низ. Прочетете го чрез event.code, например в обработчик keydown или keyup. То е част от уеб API UI Events, а не от самия ECMAScript.

Имена като KeyQ, Digit2 и ShiftLeft описват позиции на клавиши, а не въведени символи. KeyQ обозначава позицията на клавиша Q в американската подредба, дори когато друга подредба задава на тази позиция различна буква. ShiftLeft и ShiftRight разграничават страните на клавиатурата.

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

Стойността по подразбиране на code е "". Виртуалните клавиатури невинаги имат еднозначен еквивалент на физическа позиция. Тествайте целевите браузъри и устройства; наличието на Node 24 не доказва поддръжка на този API на браузъра.

Примерът задава изрично code и key в синтетични събития. Той показва две различни значения при един и същ code; не проверява съответствието с реална клавиатура и не симулира натискане на физически клавиш.

Примери

const events = [
  new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
  new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];

for (const event of events) {
  console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}

Резултат

KeyQ | q | false
KeyQ | Q | true

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

Източници