Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.key

KeyboardEvent.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.

Zdroje