CKTIS / JavaScript
KeyboardEvent.code — fizička tipka umjesto znaka
KeyboardEvent.code prepoznaje fizički položaj tipke neovisno o rasporedu tipkovnice i modifikatorima. Saznajte kako se code razlikuje od key i kada unos teksta i virtualne tipkovnice zahtijevaju drukčiji pristup.
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.codeKeyboardEvent.code je svojstvo samo za čitanje koje vraća identifikator fizičke tipke kao niz znakova. Čitajte ga preko event.code, primjerice u rukovatelju keydown ili keyup. Pripada web-API-ju UI Events, a ne samom ECMAScriptu.
Nazivi kao što su KeyQ, Digit2 i ShiftLeft opisuju položaje tipki, a ne upisane znakove. KeyQ označava položaj tipke Q na američkom rasporedu, čak i kada joj drugi raspored dodjeljuje drugo slovo. ShiftLeft i ShiftRight razlikuju strane tipkovnice.
Za razliku od code, key opisuje značenje tipke uzimajući u obzir raspored i modifikatore. Odaberite code za upravljanje na temelju položaja, a key za značenje tipke. Za praćenje uređivanja teksta koristite input umjesto sastavljanja teksta iz kodova tipki.
Zadana vrijednost svojstva code jest "". Virtualne tipkovnice nemaju uvijek jednoznačan ekvivalent fizičkom položaju. Testirajte ciljane preglednike i uređaje; prisutnost Nodea 24 ne dokazuje podršku za ovaj API preglednika.
Primjer izričito postavlja code i key u sintetičkim događajima. Prikazuje dva različita značenja uz isti code; ne provjerava mapiranje stvarne tipkovnice niti simulira pritisak fizičke tipke.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.