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