Codice del tasto Esc

Esc invia event.key "Escape", event.code "Escape" e keyCode 27.

Tutti i valori in breve

Valori per Esc
Tastoevent.codeevent.keykeyCodeevent.location
EscEscapeEscape270 (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 Esc

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

Codice per reagire a Esc

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

Quale valore usare

Controlla event.key === 'Escape'. C’è un solo tasto Esc e invia lo stesso valore in ogni layout, quindi qui event.key ed event.code dicono la stessa cosa. key si legge meglio.

keyCode 27 arriva ancora in ogni browser, ma è deprecato.

I browser molto vecchi inviavano invece "Esc": Internet Explorer e Firefox 36 e precedenti. Accetta entrambi solo se li supporti ancora.

Dove si sbaglia di solito

Esc esce dallo schermo intero e il mio gestore non può fermarlo

Nello schermo intero (e nel blocco del puntatore), Esc è del browser. Esce sempre, e preventDefault() non serve; il tuo gestore può anche non vedere quell’Esc. Ascolta fullscreenchange per sapere quando è successo. In Chromium, un gioco può chiamare navigator.keyboard.lock(['Escape']) mentre è a schermo intero; l’utente allora tiene premuto Esc per uscire.

La finestra di dialogo si chiude anche se ho annullato l’evento

Un <dialog> modale si chiude da solo con Esc. Prima fa scattare un evento cancel, che puoi fermare:

dialog.addEventListener('cancel', (event) => event.preventDefault());

Chrome te lo lascia fermare una sola volta: premi di nuovo Esc senza fare click su nulla nel frattempo e si chiude comunque. Per tenere aperta una finestra di dialogo di proposito, imposta closedby="none" dove è supportato, e salva il lavoro dell’utente nell’evento close invece di contare su cancel.

Esc chiude due cose insieme

Quando un menu è aperto dentro una finestra di dialogo, entrambi sentono lo stesso Esc. Chiudi solo l’elemento più interno: gestisci Esc sul menu, poi chiama event.stopPropagation() perché il codice della finestra non parta, ed event.preventDefault() perché anche un <dialog> nativo non si chiuda: chiuderlo è l’azione predefinita del browser, non di un gestore.

Esc in un campo di ricerca lo svuota

In Chrome e in altri browser, Esc svuota un <input type="search">. Se Esc deve invece chiudere la tua casella di ricerca, chiama preventDefault() in keydown, oppure svuota e chiudi in un solo passaggio.

Su una tastiera per iPad non c’è il tasto Esc

Alcune tastiere per iPad non hanno il tasto Esc, e i telefoni non lo hanno mai. Metti sempre anche un pulsante di chiusura visibile. Esc è una scorciatoia, non l’unica via d’uscita.

Esc come via d’uscita

Chi usa la tastiera si aspetta che Esc chiuda menu, popup e finestre di dialogo, e che riporti il focus sul pulsante che li ha aperti. Se un elemento cattura ogni tasto, come un editor di codice o la casella dello strumento Codice di un tasto (keycode), lascia che Esc lo liberi, così Tab riprende a spostarsi. Così chi usa la tastiera non resta bloccato.