Codice del tasto Invio (Enter)

Invio (Enter) invia event.key "Enter" e keyCode 13. Entrambi i tasti Invio li condividono; event.code ed event.location li distinguono.

Tutti i valori in breve

Valori per Invio
Tastoevent.codeevent.keykeyCodeevent.location
InvioEnterEnter130 (Standard)
Invio (tastierino)NumpadEnterEnter133 (Tastierino numerico)

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 Invio

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

Codice per reagire a Invio

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

Quale valore usare

Controlla event.key === 'Enter'. È uguale per il tasto Invio principale e per quello del tastierino numerico, in ogni layout, e anche sulle tastiere dei telefoni che inviano un vero Invio.

Usa event.code solo quando i due tasti devono fare cose diverse: Enter è il tasto grande, NumpadEnter è quello del tastierino numerico. Il tasto Invio del Mac, che può riportare la scritta “return”, invia anch’esso Enter.

keyCode 13 arriva ancora in ogni browser, quindi il vecchio codice continua a funzionare, ma è deprecato.

Dove si sbaglia di solito

Invio manda il messaggio mentre qualcuno scrive ancora in giapponese, cinese o coreano

Con un metodo di input, Invio prima conferma il carattere che si sta componendo. Il tuo gestore di keydown vede anche quell’Invio. Saltalo mentre un carattere è in composizione:

if (event.isComposing || event.keyCode === 229) return;

Controlla entrambi: Safari invia l’Invio di conferma con isComposing false ma keyCode 229.

Premere Invio in un campo di testo invia il modulo

È l’invio implicito del browser. Chiama event.preventDefault() nel gestore di keydown se Invio deve fare altro, oppure ascolta l’evento submit del modulo invece del tasto: prende anche il pulsante Vai delle tastiere dei telefoni.

Il gestore parte due volte o molte volte

Tenere premuto Invio ripete il keydown. Ignora le ripetizioni con if (event.repeat) return; quando Invio avvia qualcosa che deve succedere una sola volta, come inviare un messaggio.

keypress o keyup non si comportano come keydown

keypress è deprecato e scatta solo per i tasti che scrivono qualcosa; scatta ancora per Invio, ma non costruirci sopra. keyup arriva dopo che il browser ha già inviato il modulo o aggiunto la nuova riga, troppo tardi per fermarlo. Usa keydown.

Invio su un telefono mostra “Vai”, “Avanti” o “Invia”

L’etichetta la decidi tu: aggiungi enterkeyhint="send" (oppure go, next, search, done) all’input. Le tastiere Android inviano la maggior parte dei tasti come keyCode 229, ma Invio di solito arriva come un vero Enter con keyCode 13.

Maiusc+Invio e Ctrl+Invio

Le caselle di chat di solito inviano con Invio e vanno a capo con Maiusc + Invio: controlla event.shiftKey. Ctrl + Invio (Comando + Invio su un Mac) è la comune scorciatoia “invia comunque”: controlla event.ctrlKey || event.metaKey. In una <textarea>, Invio va a capo a meno che tu chiami preventDefault().