Kody klawiszy strzałek

Strzałki wysyłają event.key "ArrowLeft", "ArrowUp", "ArrowRight" i "ArrowDown" oraz keyCode 37, 38, 39 i 40.

Wszystkie wartości w skrócie

Klawisze strzałek – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
Strzałka w lewoArrowLeftArrowLeft370 (Zwykły)
Strzałka w góręArrowUpArrowUp380 (Zwykły)
Strzałka w prawoArrowRightArrowRight390 (Zwykły)
Strzałka w dółArrowDownArrowDown400 (Zwykły)

keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.

Naciśnij go tutaj

Kliknij tutaj, a potem naciśnij strzałkę

Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.

Kod, który reaguje na klawisz: Strzałka w lewo

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'ArrowLeft') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ArrowLeft') {
    // Twój kod tutaj
  }
});
Stary kod, który nadal używa keyCode (jego używanie nie jest już zalecane)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 37) {
    // Twój kod tutaj
  }
});

Której wartości użyć

Sprawdzaj event.key. Wartości klawiszy strzałek nie zależą od układu klawiatury, więc key i code mają te same nazwy: ArrowLeft, ArrowUp, ArrowRight i ArrowDown.

Użyj event.code, gdy klawiatura numeryczna ma nie być brana pod uwagę. Przy wyłączonym Num Lock klawisze 4, 8, 6 i 2 na klawiaturze numerycznej też wysyłają key ArrowLeft, ArrowUp, ArrowRight i ArrowDown oraz keyCode od 37 do 40. Zdradzają je tylko code (Numpad4, Numpad8, Numpad6, Numpad2) i location równe 3.

Starsze kody zaczynają się od strzałki w lewo i rosną zgodnie z ruchem wskazówek zegara: 37 w lewo, 38 w górę, 39 w prawo, 40 w dół. Każda przeglądarka nadal je wysyła, ale są wycofywane.

Co sprawia kłopoty

Strona przewija się, gdy gracz naciska strzałkę

Przewijanie to domyślne działanie strzałek. Wywołaj event.preventDefault() w keydown. Nasłuchuj zdarzeń na elemencie gry (nadaj mu tabindex="0"), a nie na window. Dzięki temu nadal można przewijać resztę strony i przesuwać kursor strzałkami w polach tekstowych:

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

Ruch się zacina albo ruch trwa w tym samym kierunku po puszczeniu klawisza

Przytrzymany klawisz wysyła jedno zdarzenie keydown, a po krótkiej przerwie kolejne, z częstotliwością ustawioną przez użytkownika. Ruch przy każdym keydown się zacina. Zamiast tego trzymaj zbiór przytrzymanych klawiszy: dodawaj event.code przy keydown, usuwaj przy keyup, a ruch wykonuj w pętli gry. Opróżniaj zbiór w zdarzeniu blur okna: jeśli ktoś przełączy okno z przytrzymanym klawiszem, jego keyup nigdy nie dotrze do twojej strony.

Stary kod sprawdza wartości Left lub Up

Internet Explorer, Edge 16 i starsze oraz Firefox 36 i starsze wysyłały "Left", "Up", "Right" i "Down". Obecne przeglądarki wysyłają nazwy z Arrow. Sprawdzaj obie wersje tylko wtedy, gdy nadal obsługujesz te przeglądarki.

Obsługa strzałek zakłóca działanie suwaka, listy lub pola tekstowego

Wiele elementów samo używa strzałek: pola tekstowe przesuwają kursor, suwaki zmieniają wartość, a przyciski opcji i <select> zmieniają wybór. Pomijaj zdarzenia, których event.target jest jednym z nich, albo pozwól im najpierw obsłużyć klawisz i sprawdź event.defaultPrevented.

Klawiatury Maca i laptopów

Laptopy Mac i wiele małych klawiatur nie ma klawiszy Home, End, Page Up ani Page Down. Na Macu przytrzymaj zamiast nich Fn ze strzałką: Fn + strzałka w lewo wysyła Home, Fn + strzałka w prawo End, Fn + strzałka w górę Page Up, a Fn + strzałka w dół Page Down. Strona dostaje wtedy te klawisze, a nie strzałkę.

Na Macu po puszczeniu strzałki naciśniętej z przytrzymanym Cmd zdarzenie keyup może nie dotrzeć do strony. Może się to zdarzyć w każdej przeglądarce. Nie opieraj na nim stanu przytrzymanych klawiszy.