CKTIS / JavaScript
KeyboardEvent.key — znaczenie klawisza
KeyboardEvent.key to tekstowa właściwość tylko do odczytu opisująca znaczenie klawisza. Uwzględnia układ klawiatury i modyfikatory; w przeciwieństwie do code nie opisuje fizycznego położenia klawisza.
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.keyKeyboardEvent.key, odczytywane jako event.key, zwraca ciąg znaków opisujący znaczenie klawisza. Dla znaków drukowalnych uwzględnia układ klawiatury i modyfikatory, np. "a" albo "A". Właściwość jest tylko do odczytu.
W UI Events nazwane wartości klawiszy należą do różnych kategorii: "Enter" do klawiszy związanych z białymi znakami, "Escape" do klawiszy interfejsu użytkownika, a "ArrowDown" do klawiszy nawigacyjnych. Spacja ma wartość " ", nie "Space". "Dead" oznacza martwy klawisz używany do składania znaków, a "Unidentified" — klawisz, którego nie udało się rozpoznać. Porównania ciągów rozróżniają wielkość liter.
Używaj key, gdy liczy się znaczenie klawisza, a code, gdy istotne jest jego fizyczne położenie. Nie traktuj zdarzeń klawiatury jako pełnego zapisu wprowadzanego tekstu; do obsługi edycji rozważ zdarzenia beforeinput i input.
To przeglądarkowy interfejs Web API zdefiniowany w UI Events, nie funkcja konkretnej edycji ECMAScript. Obecność Node 24 nie potwierdza jego obsługi. Przykład jawnie ustawia key i code: konstruktor nie wylicza key z code ani shiftKey. Testuje odczyt wartości, nie rzeczywistą klawiaturę; obsługę w docelowych przeglądarkach należy sprawdzić osobno.
Przykłady
const events = [
new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];
console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));Wynik
a:KeyA A:KeyA Enter:Enter
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.