CKTIS / JavaScript
KeyboardEvent.key — význam klávesu
KeyboardEvent.key je vlastnosť typu reťazec iba na čítanie, ktorá opisuje význam klávesu. Zohľadňuje rozloženie klávesnice a modifikátory; na rozdiel od code neopisuje fyzickú polohu klávesu.
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.keyKeyboardEvent.key, čítaná ako event.key, vracia reťazec opisujúci význam klávesu. Pri tlačiteľných znakoch zohľadňuje rozloženie klávesnice a modifikátory, napríklad "a" alebo "A". Táto vlastnosť je iba na čítanie.
UI Events zaraďuje pomenované hodnoty klávesov do rôznych kategórií: "Enter" medzi klávesy súvisiace s bielymi znakmi, "Escape" medzi klávesy používateľského rozhrania a "ArrowDown" medzi navigačné klávesy. Medzerník má hodnotu " ", nie "Space". "Dead" označuje mŕtvy kláves používaný na skladanie znakov, zatiaľ čo "Unidentified" znamená, že kláves nebolo možné identifikovať. Porovnávanie reťazcov rozlišuje veľké a malé písmená.
Používajte key, keď záleží na význame klávesu, a code, keď záleží na jeho fyzickej polohe. Nepovažujte udalosti klávesnice za úplný záznam textového vstupu; pri úprave textu zvážte udalosti beforeinput a input.
Ide o webové API prehliadača definované v UI Events, nie o funkciu konkrétneho vydania ECMAScriptu. Prítomnosť Node 24 nepotvrdzuje podporu. Príklad výslovne nastavuje key a code: konštruktor nepočíta key z code ani shiftKey. Testuje čítanie hodnôt, nie skutočnú klávesnicu; podporu v cieľových prehliadačoch treba overiť osobitne.
Príklady
const events = [
new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];
console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));Výsledok
a:KeyA A:KeyA Enter:Enter
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.