Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

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

Izvori