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