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