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

CKTIS / JavaScript

KeyboardEvent.code — fizična tipka namesto znaka

KeyboardEvent.code določa fizični položaj tipke neodvisno od razporeditve tipkovnice in modifikatorjev. Spoznajte razliko med code in key ter kdaj vnos besedila in navidezne tipkovnice zahtevajo drugačen pristop.

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

KeyboardEvent.code je lastnost samo za branje, ki kot niz vrne identifikator fizične tipke. Preberete jo prek event.code, na primer v obdelovalniku keydown ali keyup. Spada v spletni API UI Events, ne v sam ECMAScript.

Imena, kot so KeyQ, Digit2 in ShiftLeft, opisujejo položaje tipk, ne vnesenih znakov. KeyQ označuje položaj tipke Q na ameriški razporeditvi, tudi če ji druga razporeditev dodeli drugo črko. ShiftLeft in ShiftRight razlikujeta strani tipkovnice.

V nasprotju z code lastnost key opisuje pomen tipke ob upoštevanju razporeditve in modifikatorjev. Za upravljanje na podlagi položaja izberite code, za pomen tipke pa key. Za spremljanje urejanja besedila uporabite input namesto sestavljanja besedila iz kod tipk.

Privzeta vrednost code je "". Navidezne tipkovnice nimajo vedno nedvoumnega ustreznika fizičnemu položaju. Preizkusite ciljne brskalnike in naprave; prisotnost Node 24 ne dokazuje podpore za ta brskalniški API.

Primer izrecno nastavi code in key v sintetičnih dogodkih. Prikazuje dva različna pomena pri istem code; ne preverja preslikave prave tipkovnice in ne simulira pritiska fizične tipke.

Primeri

const events = [
  new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
  new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];

for (const event of events) {
  console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}

Rezultat

KeyQ | q | false
KeyQ | Q | true

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

Viri