Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

KeyboardEvent.key — pomen tipke

KeyboardEvent.key je lastnost vrste niz, ki je samo za branje in opisuje pomen tipke. Upošteva razporeditev tipkovnice in modifikatorje; za razliko od code ne opisuje fizičnega položaja tipke.

Različica: 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.key

KeyboardEvent.key, prebran kot event.key, vrne niz, ki opisuje pomen tipke. Pri natisljivih znakih upošteva razporeditev tipkovnice in modifikatorje, na primer "a" ali "A". Lastnost je samo za branje.

UI Events razvršča poimenovane vrednosti tipk v različne skupine: "Enter" spada med tipke za bele znake, "Escape" med tipke uporabniškega vmesnika, "ArrowDown" pa med navigacijske tipke. Preslednica ima vrednost " ", ne "Space". "Dead" označuje mrtvo tipko, ki se uporablja za sestavljanje znakov, "Unidentified" pa pomeni, da tipke ni bilo mogoče prepoznati. Primerjave nizov razlikujejo med velikimi in malimi črkami.

Uporabite key, kadar je pomemben pomen tipke, in code, kadar je pomemben njen fizični položaj. Dogodkov tipkovnice ne obravnavajte kot popoln zapis vnosa besedila; za urejanje upoštevajte dogodka beforeinput in input.

To je brskalniški spletni API, opredeljen v UI Events, in ne funkcija določene izdaje ECMAScripta. Prisotnost Node 24 ne dokazuje podpore. Primer izrecno nastavi key in code: konstruktor ne izračuna key iz code ali shiftKey. Preizkuša dostop do vrednosti, ne prave tipkovnice; podporo v ciljnih brskalnikih je treba preveriti ločeno.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri