Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

KeyboardEvent.key — význam klávesy

KeyboardEvent.key je vlastnost typu řetězec pouze pro čtení, která popisuje význam klávesy. Zohledňuje rozložení klávesnice a modifikátory; na rozdíl od code nepopisuje fyzickou polohu klávesy.

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

KeyboardEvent.key, čtená jako event.key, vrací řetězec popisující význam klávesy. U tisknutelných znaků zohledňuje rozložení klávesnice a modifikátory, například "a" nebo "A". Tato vlastnost je pouze pro čtení.

UI Events řadí pojmenované hodnoty kláves do různých kategorií: "Enter" mezi klávesy související s bílými znaky, "Escape" mezi klávesy uživatelského rozhraní a "ArrowDown" mezi navigační klávesy. Mezerník má hodnotu " ", nikoli "Space". "Dead" označuje mrtvou klávesu používanou ke skládání znaků, zatímco "Unidentified" znamená, že klávesu nebylo možné identifikovat. Porovnávání řetězců rozlišuje velikost písmen.

Používejte key, když záleží na významu klávesy, a code, když záleží na její fyzické poloze. Nepovažujte události klávesnice za úplný záznam textového vstupu; při úpravách zvažte události beforeinput a input.

Jde o webové API prohlížeče definované v UI Events, nikoli o funkci konkrétní edice ECMAScriptu. Přítomnost Node 24 nepotvrzuje podporu. Příklad výslovně nastavuje key a code: konstruktor nepočítá key z code ani shiftKey. Testuje čtení hodnot, nikoli skutečnou klávesnici; podporu v cílových prohlížečích je nutné ověřit zvlášť.

Pří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ýsledek

a:KeyA
A:KeyA
Enter:Enter

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.

Zdroje