CKTIS / JavaScript
KeyboardEvent.code — fyzická klávesa místo znaku
KeyboardEvent.code určuje fyzickou polohu klávesy nezávisle na rozložení klávesnice a modifikátorech. Zjistěte, jak se code liší od key a kdy zadávání textu a virtuální klávesnice vyžadují jiný přístup.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.codeKeyboardEvent.code je vlastnost pouze pro čtení, která vrací identifikátor fyzické klávesy jako řetězec. Čtěte ji přes event.code, například v obslužné funkci keydown nebo keyup. Patří do webového API UI Events, nikoli do samotného ECMAScriptu.
Názvy jako KeyQ, Digit2 a ShiftLeft popisují polohy kláves, nikoli napsané znaky. KeyQ označuje polohu klávesy Q v americkém rozložení, i když jí jiné rozložení přiřazuje jiné písmeno. ShiftLeft a ShiftRight rozlišují strany klávesnice.
Na rozdíl od code popisuje key význam klávesy s ohledem na rozložení a modifikátory. Pro ovládání založené na poloze zvolte code, pro význam klávesy key. Chcete-li sledovat úpravy textu, použijte input místo skládání textu z kódů kláves.
Výchozí hodnota code je "". Virtuální klávesnice nemají vždy jednoznačný ekvivalent fyzické polohy. Otestujte cílové prohlížeče a zařízení; samotná přítomnost Node 24 nedokazuje podporu tohoto rozhraní prohlížeče.
Příklad výslovně nastavuje code a key v syntetických událostech. Ukazuje dva různé významy se stejným code; netestuje mapování skutečné klávesnice ani nesimuluje stisk fyzické klávesy.
Příklady
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}`);
}Výsledek
KeyQ | q | false KeyQ | Q | true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.