Właściwość key wydarzenia KeyboardEvent

DOM wydarzenie KeyboardEvent

Definicja i użycie

Właściwość key zwraca identyfikator klawisza naciśniętego w momencie zdarzenia naciśnięcia klawisza.

Identyfikator klawisza to ciąg znaków identyfikujący przycisk klawiatury. Wartość zwracana przez tę właściwość może być jednym z następujących ciągów znaków:

  • Pojedynczy znak (np. "a", "W", "4", "+" lub "$")
  • Wiele znaków (np. "F1", "Enter", "HOME" lub "CAPS LOCK")

Komentarz:Właściwość tylko do odczytu.

Wskazówka:Jeśli chcesz wiedzieć, czy w momencie zdarzenia naciśnięcia klawisza zostały naciśnięte "ALT", "CTRL", "META" lub "SHIFT", użyj altKey,ctrlKey,metaKey lub shiftKey Atrybut.

Przykład

Przykład 1

Pobierz przycisk klawiatury naciśnięty w momencie zdarzenia naciśnięcia klawisza:

var x = event.key;

Spróbuj sam

Przykład 2

Jeśli użytkownik nacisnął przycisk "A", wyświetl pewien tekst:

var x = event.key;
// Jeśli naciśnięty przycisk klawiatury to "a" lub "A" (używając CapsLock lub Shift), wyświetl pewien tekst.
if (x == "a" || x == "A") { 
  alert ("Naciśnięto przycisk 'A'!");
}

Spróbuj sam

Gramatyka

event.key

Szczegóły techniczne

Zwracana wartość:

Ciąg znaków, reprezentujący naciśnięty przycisk klawiatury.

Możliwe wartości:

  • Pojedynczy znak (np. "a", "W", "4", "+" lub "$")
  • Wiele znaków (np. "F1", "Enter", "HOME" lub "CAPS LOCK")

Komentarz:Zwraca nieokreślone w Safari.
Wersja DOM: DOM Poziom 3

Obsługa przeglądarek

Liczby w tabeli wskazują na pierwszą wersję przeglądarki, która w pełni obsługuje ten atrybut.

Atrybut Chrome IE Firefox Safari Opera
klucz 51.0 9.0 23.0 Nie obsługuje 38.0

Strony związane

Przeglądarka HTML DOM:Atrybut keyCode zdarzenia KeyboardEvent

Przeglądarka HTML DOM:Atrybut which zdarzenia KeyboardEvent

Przeglądarka HTML DOM:Atrybut charCode zdarzenia KeyboardEvent

DOM wydarzenie KeyboardEvent