Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

KeyboardEvent.code — fyzický kláves namiesto znaku

KeyboardEvent.code identifikuje fyzickú polohu klávesu nezávisle od rozloženia klávesnice a modifikátorov. Zistite, ako sa code líši od key a kedy zadávanie textu a virtuálne klávesnice vyžadujú iný prístup.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.code

KeyboardEvent.code je vlastnosť iba na čítanie, ktorá vracia identifikátor fyzického klávesu ako reťazec. Čítajte ju cez event.code, napríklad v obslužnej funkcii keydown alebo keyup. Patrí do webového API UI Events, nie do samotného ECMAScriptu.

Názvy ako KeyQ, Digit2 a ShiftLeft opisujú polohy klávesov, nie napísané znaky. KeyQ označuje polohu klávesu Q v americkom rozložení, aj keď mu iné rozloženie priraďuje iné písmeno. ShiftLeft a ShiftRight rozlišujú strany klávesnice.

Na rozdiel od code opisuje key význam klávesu s ohľadom na rozloženie a modifikátory. Pre ovládanie založené na polohe zvoľte code, pre význam klávesu key. Ak chcete sledovať úpravy textu, použite input namiesto skladania textu z kódov klávesov.

Predvolená hodnota code je "". Virtuálne klávesnice nemajú vždy jednoznačný ekvivalent fyzickej polohy. Otestujte cieľové prehliadače a zariadenia; samotná prítomnosť Node 24 nedokazuje podporu tohto rozhrania prehliadača.

Príklad výslovne nastavuje code a key v syntetických udalostiach. Ukazuje dva rôzne významy s rovnakým code; netestuje mapovanie skutočnej klávesnice ani nesimuluje stlačenie fyzického klávesu.

Príklady

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}`);
}

Výsledok

KeyQ | q | false
KeyQ | Q | true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje