CKTIS / JavaScript
Polia KeyboardEvent: význam klávesu, poloha a stav
Rozlišujte hodnotu klávesu od jeho fyzickej polohy a sledujte opakovanie, stav Shiftu a kompozíciu textu. Tieto polia KeyboardEvent pomáhajú spracovať klávesové skratky bez zámeny rozloženia klávesnice so zadávaným textom.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent opisuje udalosti klávesnice, napríklad keydown a keyup. Päť tu opísaných vlastností (key, code, repeat, shiftKey a isComposing) je iba na čítanie, no do niektorých vlastností zdedených z Event, napríklad cancelBubble, možno zapisovať. KeyboardEvent.key je reťazec, ktorý označuje význam klávesu s ohľadom na rozloženie a modifikátory, napríklad "z", "Z" alebo "Enter". KeyboardEvent.code je reťazec, ktorý identifikuje fyzickú polohu klávesu bez ohľadu na rozloženie: na klávesnici QWERTZ môže byť "KeyY" spojené s key: "Z". Na význam klávesu použite key a na ovládanie založené na polohe code.
KeyboardEvent.repeat je logická hodnota: true označuje automatické opakovanie podržaného klávesu, nie počet opakovaní. V obsluhe keydown môže if (event.repeat) return; vynechať opakované akcie. KeyboardEvent.shiftKey udáva, či bol Shift aktívny v okamihu udalosti; neznamená to, že sa samotná udalosť týka Shiftu. Pri stlačení klávesu Shift (keydown) je hodnota true; pri jeho uvoľnení (keyup) môže zostať true, ak je druhý kláves Shift stále stlačený.
KeyboardEvent.isComposing je logická hodnota označujúca udalosť medzi compositionstart a compositionend, napríklad počas kompozície textu pomocou IME. Vynechávanie skratiek, keď má hodnotu true, obmedzuje rušenie kompozície, ale nezachytí všetky hraničné prípady IME: na začiatku alebo konci kompozície môže mať hodnotu false. Udalosti klávesnice nenahrádzajú udalosť input pri sledovaní zmien textu.
Ide o Web API prehliadača, nie o funkcie konkrétnej edície ECMAScriptu; Node 24 v repozitári nedokladá ich dostupnosť. Overte kompatibilitu každej vlastnosti v cieľových prehliadačoch; MDN označuje repeat ako Baseline 2025, čo nezaručuje podporu v starších verziách. Príklad vytvára syntetickú udalosť s výslovne nastavenými hodnotami: overuje prístup k poliam, nie skutočné stlačenia klávesov ani správanie IME.
Prí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ýsledok
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.