CKTIS / JavaScript
KeyboardEvent.key — značenje tipke
KeyboardEvent.key je svojstvo vrste niz koje se može samo čitati i opisuje značenje tipke. Uvažava raspored tipkovnice i modifikatore; za razliku od code ne opisuje fizički položaj tipke.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
event.keyKeyboardEvent.key, očitan kao event.key, vraća niz koji opisuje značenje tipke. Za ispisive znakove uvažava raspored tipkovnice i modifikatore, na primjer "a" ili "A". Svojstvo se može samo čitati.
UI Events razvrstava imenovane vrijednosti tipki u različite kategorije: "Enter" je među tipkama povezanima s bjelinama, "Escape" među tipkama korisničkog sučelja, a "ArrowDown" među navigacijskim tipkama. Razmaknica ima vrijednost " ", a ne "Space". "Dead" označava mrtvu tipku koja se koristi za sastavljanje znakova, dok "Unidentified" znači da se tipka nije mogla identificirati. Usporedbe nizova razlikuju velika i mala slova.
Upotrijebite key kada je važno značenje tipke, a code kada je važan njezin fizički položaj. Nemojte smatrati događaje tipkovnice potpunim zapisom unosa teksta; za uređivanje razmotrite događaje beforeinput i input.
Ovo je web-API preglednika definiran u UI Events, a ne značajka određenog izdanja ECMAScripta. Sama prisutnost Nodea 24 ne dokazuje podršku. Primjer izričito postavlja key i code: konstruktor ne izračunava key iz code ili shiftKey. Provjerava čitanje vrijednosti, a ne stvarnu tipkovnicu; podršku u ciljanim preglednicima treba provjeriti zasebno.
Primjeri
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"));Rezultat
a:KeyA A:KeyA Enter:Enter
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.