Codici dei tasti freccia

Le frecce inviano event.key "ArrowLeft", "ArrowUp", "ArrowRight" e "ArrowDown", e keyCode 37, 38, 39 e 40.

Tutti i valori in breve

Valori per Tasti freccia
Tastoevent.codeevent.keykeyCodeevent.location
Freccia sinistraArrowLeftArrowLeft370 (Standard)
Freccia suArrowUpArrowUp380 (Standard)
Freccia destraArrowRightArrowRight390 (Standard)
Freccia giùArrowDownArrowDown400 (Standard)

Valori di keyCode inviati da Chrome ed Edge su Windows. Le colonne Mac (Chrome e Safari) e Firefox mostrano solo i valori diversi. Alcuni valori cambiano anche in base al sistema, come spiegato qui sotto. event.which ha sempre lo stesso valore di keyCode. Il valore di event.key si riferisce a una tastiera inglese (US) senza Maiusc.

Premilo qui

Fai click qui, poi premi un tasto freccia

Usi solo la tastiera? Premi Esc, poi Tab, per uscire dal riquadro.

Codice per reagire a Freccia sinistra

Consigliato: riconosci event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'ArrowLeft') {
    // Il tuo codice qui
  }
});
Riconosci il posto del tasto: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ArrowLeft') {
    // Il tuo codice qui
  }
});
Vecchio codice che usa ancora keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 37) {
    // Il tuo codice qui
  }
});

Quale valore usare

Controlla event.key. Le frecce non cambiano con il layout della tastiera, quindi key e code hanno gli stessi nomi: ArrowLeft, ArrowUp, ArrowRight e ArrowDown.

Usa event.code quando il tastierino numerico non deve contare. Con Bloc Num spento, anche i tasti 4, 8, 6 e 2 del tastierino inviano key “ArrowLeft”, “ArrowUp”, “ArrowRight” e “ArrowDown” e keyCode da 37 a 40. Solo il loro code (Numpad4, Numpad8, Numpad6, Numpad2) e location 3 li tradiscono.

I vecchi numeri girano in senso orario a partire da sinistra: 37 sinistra, 38 su, 39 destra, 40 giù. Ogni browser li invia ancora, ma sono deprecati.

Dove si sbaglia di solito

La pagina scorre quando il giocatore preme una freccia

Lo scorrimento è l’azione predefinita delle frecce. Chiama event.preventDefault() in keydown. Ascolta sul gioco stesso (dagli tabindex="0") e non su window, così il resto della pagina scorre ancora e i campi di testo spostano ancora il cursore:

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

Il movimento va a scatti, o una direzione resta bloccata

Un tasto che tieni premuto invia un evento keydown. Dopo una pausa, invia altri eventi keydown alla frequenza di ripetizione impostata. Se fai muovere il personaggio a ogni evento, il movimento va a scatti. Tieni invece un insieme di tasti premuti: aggiungi event.code a ogni keydown e rimuovilo al keyup. Aggiorna il movimento del personaggio nel ciclo del gioco. Svuota l’insieme nell’evento blur della finestra: se l’utente cambia finestra tenendo un tasto premuto, il suo keyup non arriva mai alla tua pagina.

Il vecchio codice controlla “Left” o “Up”

Internet Explorer, Edge 16 e precedenti, e Firefox 36 e precedenti inviavano "Left", "Up", "Right" e "Down". I browser attuali inviano i nomi con Arrow. Controlla entrambi solo se supporti ancora quei browser.

Il tuo gestore delle frecce litiga con un cursore, un elenco o un campo di testo

Molti elementi usano le frecce da soli: i campi di testo spostano il cursore, i cursori (slider) cambiano valore, i pulsanti di opzione e il <select> cambiano la scelta. Salta gli eventi il cui event.target è uno di questi, oppure lascia che gestiscano prima il tasto e controlla event.defaultPrevented.

Tastiere di Mac e portatili

I portatili Mac e molte tastiere piccole non hanno i tasti Home, Fine, Pag su e Pag giù. Su un Mac tieni premuto Fn con una freccia: Fn + freccia sinistra invia Home, Fn + freccia destra invia Fine, Fn + freccia su invia Pag su e Fn + freccia giù invia Pag giù. La pagina riceve quei tasti, non una freccia.

Su un Mac, il keyup di una freccia premuta mentre Comando è tenuto premuto può non arrivare, in nessun browser. Non farci affidamento per lo stato dei tasti premuti.