Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

KeyboardEvent.code — fizyczny klawisz zamiast znaku

KeyboardEvent.code identyfikuje fizyczną pozycję klawisza niezależnie od układu klawiatury i modyfikatorów. Poznaj różnicę między code a key oraz ograniczenia przy obsłudze tekstu i klawiatur wirtualnych.

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

Składnia

event.code

KeyboardEvent.code to właściwość tylko do odczytu zwracająca identyfikator fizycznego klawisza jako ciąg znaków. Odczytuj ją przez event.code, na przykład w obsłudze keydown lub keyup. To część Web API UI Events, a nie samego ECMAScript.

Nazwy takie jak KeyQ, Digit2 i ShiftLeft opisują pozycje klawiszy, nie wpisywane znaki. KeyQ oznacza pozycję klawisza Q w układzie US, nawet gdy inny układ przypisuje jej inną literę. ShiftLeft i ShiftRight rozróżniają strony klawiatury.

W przeciwieństwie do code, key opisuje znaczenie klawisza z uwzględnieniem układu i modyfikatorów. Wybieraj code dla sterowania opartego na pozycjach, a key dla znaczenia klawisza. Do obserwowania edycji tekstu używaj input, zamiast odtwarzać tekst z kodów klawiszy.

Domyślna wartość code to "". Klawiatury wirtualne nie zawsze mają jednoznaczny odpowiednik fizycznej pozycji. Testuj docelowe przeglądarki i urządzenia; obecność Node 24 nie dowodzi obsługi tego API przeglądarkowego.

Przykład jawnie ustawia code i key w syntetycznych zdarzeniach. Pokazuje dwa różne znaczenia przy tym samym code; nie sprawdza mapowania rzeczywistej klawiatury ani nie symuluje fizycznego naciśnięcia.

Przykłady

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

Wynik

KeyQ | q | false
KeyQ | Q | true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła