Codice del tasto Esc
Esc invia event.key "Escape", event.code "Escape" e keyCode 27.
Tutti i valori in breve
| Tasto | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Esc | Escape | Escape | 27 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
// Il tuo codice qui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Escape') {
// Il tuo codice qui
}
});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.