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