CKTIS / JavaScript
Pole KeyboardEvent: význam klávesy, pozice a stav
Rozlišujte hodnotu klávesy od její fyzické pozice a sledujte opakování, stav Shiftu a kompozici textu. Tato pole KeyboardEvent pomáhají zpracovávat klávesové zkratky bez záměny rozložení klávesnice za zadávaný text.
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.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent popisuje události klávesnice, například keydown a keyup. Pět zde popsaných vlastností (key, code, repeat, shiftKey a isComposing) je pouze pro čtení, do některých vlastností zděděných z Event, například cancelBubble, však lze zapisovat. KeyboardEvent.key je řetězec, který označuje význam klávesy s ohledem na rozložení a modifikátory, například "z", "Z" nebo "Enter". KeyboardEvent.code je řetězec, který identifikuje fyzickou pozici klávesy bez ohledu na rozložení: na klávesnici QWERTZ může být "KeyY" spojeno s key: "Z". Pro význam klávesy použijte key a pro ovládání založené na pozici code.
KeyboardEvent.repeat je logická hodnota: true označuje automatické opakování podržené klávesy, nikoli počet opakování. V obsluze keydown může if (event.repeat) return; vynechat opakované akce. KeyboardEvent.shiftKey udává, zda byl Shift aktivní v okamžiku události; neznamená to, že se událost sama týká Shiftu. Při stisku klávesy Shift (keydown) je hodnota true; při jejím uvolnění (keyup) může zůstat true, pokud je druhá klávesa Shift stále stisknutá.
KeyboardEvent.isComposing je logická hodnota označující událost mezi compositionstart a compositionend, například během kompozice textu pomocí IME. Vynechávání zkratek, když má hodnotu true, omezuje rušení kompozice, ale nezachytí všechny hraniční případy IME: na začátku nebo konci kompozice může mít hodnotu false. Události klávesnice nenahrazují událost input při sledování změn textu.
Jde o Web API prohlížeče, nikoli o funkce konkrétní edice ECMAScriptu; Node 24 v repozitáři nedokládá jejich dostupnost. Ověřte kompatibilitu každé vlastnosti v cílových prohlížečích; MDN označuje repeat jako Baseline 2025, což nezaručuje podporu ve starších verzích. Příklad vytváří syntetickou událost s výslovně nastavenými hodnotami: ověřuje přístup k polím, nikoli skutečné stisky kláves nebo chování IME.
Příklady
(() => {
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 }));
})();Výsledek
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}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.