Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła