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