Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

KeyboardEvent.code — fyzická klávesa místo znaku

KeyboardEvent.code určuje fyzickou polohu klávesy nezávisle na rozložení klávesnice a modifikátorech. Zjistěte, jak se code liší od key a kdy zadávání textu a virtuální klávesnice vyžadují jiný přístup.

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

Syntaxe

event.code

KeyboardEvent.code je vlastnost pouze pro čtení, která vrací identifikátor fyzické klávesy jako řetězec. Čtěte ji přes event.code, například v obslužné funkci keydown nebo keyup. Patří do webového API UI Events, nikoli do samotného ECMAScriptu.

Názvy jako KeyQ, Digit2 a ShiftLeft popisují polohy kláves, nikoli napsané znaky. KeyQ označuje polohu klávesy Q v americkém rozložení, i když jí jiné rozložení přiřazuje jiné písmeno. ShiftLeft a ShiftRight rozlišují strany klávesnice.

Na rozdíl od code popisuje key význam klávesy s ohledem na rozložení a modifikátory. Pro ovládání založené na poloze zvolte code, pro význam klávesy key. Chcete-li sledovat úpravy textu, použijte input místo skládání textu z kódů kláves.

Výchozí hodnota code je "". Virtuální klávesnice nemají vždy jednoznačný ekvivalent fyzické polohy. Otestujte cílové prohlížeče a zařízení; samotná přítomnost Node 24 nedokazuje podporu tohoto rozhraní prohlížeče.

Příklad výslovně nastavuje code a key v syntetických událostech. Ukazuje dva různé významy se stejným code; netestuje mapování skutečné klávesnice ani nesimuluje stisk fyzické klávesy.

Pří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ýsledek

KeyQ | q | false
KeyQ | Q | true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje