Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

KeyboardEvent: wartość klawisza i automatyczne powtarzanie

Użyj `key`, aby rozpoznać wartość klawisza, a `repeat`, aby odróżnić pierwsze naciśnięcie od automatycznych powtórzeń podczas przytrzymania.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key to właściwość tylko do odczytu, która zwraca ciąg znaków, np. "Enter", "a" albo "A". Wartość zależy od układu klawiatury i aktywnych modyfikatorów, takich jak Shift. W przeciwieństwie do code, które wskazuje fizyczne położenie klawisza, key może się zmienić między kolejnymi zdarzeniami, jeśli zmieni się stan modyfikatora.

KeyboardEvent.repeat to właściwość logiczna tylko do odczytu. W rzeczywistych zdarzeniach keydown ma wartość false przy pierwszym naciśnięciu i true przy kolejnych zdarzeniach wywołanych automatycznym powtarzaniem. Nie informuje o tym, czy klawisz jest obecnie wciśnięty. Nie każdy klawisz się powtarza, a tempo powtórzeń zależy od środowiska.

Aby wykonać akcję raz na naciśnięcie klawisza Enter, sprawdź event.key === "Enter" && !event.repeat w obsłudze keydown. Jeśli akcja ma się powtarzać podczas przytrzymania, nie odrzucaj zdarzeń na podstawie repeat.

KeyboardEvent należy do API platformy webowej, a nie do ECMAScript 2024. Nie zakładaj jego dostępności w każdym środowisku JavaScript; sprawdź obsługę w środowisku docelowym.

Przykłady

{
  function handleKeydown(event) {
    if (event.key !== "Enter" || event.repeat) return;
    console.log("activate");
  }

  handleKeydown({ key: "Enter", repeat: false });
  handleKeydown({ key: "Enter", repeat: true });
  handleKeydown({ key: "Escape", repeat: false });
}

Wynik

activate

Uruchom kod w Node.js lub w konsoli przeglądarki. Funkcja otrzymuje bezpośrednio trzy zwykłe obiekty z właściwościami `key` i `repeat`, a nie zdarzenia klawiatury. Tylko dla pierwszego wypisuje `activate`; przykład sprawdza warunek, a nie tempo powtórzeń.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 38 · Średniozaawansowany · Wersja: 3

Źródła