Código de la tecla Esc (Escape)
Esc envía event.key "Escape", event.code "Escape" y keyCode 27.
Todos los valores de un vistazo
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Esc | Escape | Escape | 27 | 0 (Normal) |
keyCode tal como lo envían Chrome y Edge en Windows. La columna de Mac (Chrome y Safari en un Mac) y la de Firefox solo muestran los números que cambian; algunas teclas también cambian según el sistema, como explica el texto de abajo. event.which es siempre el mismo número que keyCode. event.key corresponde a un teclado inglés (US) sin pulsar Mayús.
Púlsala aquí
Haz clic aquí y pulsa Esc
¿Usas solo el teclado? Pulsa Esc y luego Tab para salir del cuadro de teclas.
Código para reaccionar a Esc
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
// Tu código aquí
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Escape') {
// Tu código aquí
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 27) {
// Tu código aquí
}
});Qué valor usar
Comprueba event.key === 'Escape'. Solo hay una tecla Esc, y envía el mismo valor en todas las distribuciones, así que aquí event.key y event.code dicen lo mismo. key se lee mejor.
keyCode 27 sigue llegando en todos los navegadores, pero está obsoleto.
Los navegadores muy antiguos enviaban "Esc" en su lugar: Internet Explorer y Firefox 36 y anteriores. Acepta los dos solo si aún das soporte a esos navegadores.
Qué suele salir mal
Esc sale de la pantalla completa y mi controlador no puede evitarlo
En pantalla completa (y con el puntero bloqueado), Esc es del navegador. Siempre sale, y preventDefault() no sirve; puede que tu controlador ni siquiera vea ese Esc. Escucha fullscreenchange para saber cuándo ha ocurrido. En Chromium, un juego puede llamar a navigator.keyboard.lock(['Escape']) en pantalla completa; entonces la persona mantiene pulsada Esc para salir.
El diálogo se cierra aunque lo haya cancelado
Al pulsar Esc, el navegador cierra automáticamente un <dialog> modal. Primero dispara un evento cancel, que puedes detener:
dialog.addEventListener('cancel', (event) => event.preventDefault());
Chrome te deja detenerlo solo una vez: pulsa Esc otra vez sin hacer clic en nada entre medias y se cierra igualmente. Para mantener un diálogo abierto a propósito, pon closedby="none" donde se admita, y guarda los cambios cuando se produzca el evento close en vez de confiar en cancel.
Esc cierra dos cosas a la vez
Cuando hay un menú abierto dentro de un diálogo, los dos oyen el mismo Esc. Cierra solo lo más interior: maneja Esc en el menú y luego llama a event.stopPropagation() para que no se ejecute el código de tu diálogo, y a event.preventDefault() para que un <dialog> nativo no se cierre también: cerrarlo es la acción por defecto del navegador, no de un controlador.
Esc en un campo de búsqueda lo vacía
En Chrome y en algunos otros navegadores, Esc vacía un <input type="search">. Si Esc debe cerrar tu cuadro de búsqueda, llama a preventDefault() en keydown, o vacía y cierra en un solo paso.
Los teclados de iPad pueden no tener tecla Esc
Algunos teclados de iPad no tienen tecla Esc, y los móviles nunca la tienen. Ofrece siempre también un botón de cerrar visible. Esc es un atajo, no la única salida.
Esc como salida
Quien usa el teclado espera que Esc cierre menús, ventanas emergentes y diálogos, y que devuelva el foco al botón que los abrió. Si un componente se queda con todas las teclas, como un editor de código o el cuadro del buscador de keycodes, deja que Esc lo suelte, para que Tab vuelva a avanzar. Así nadie se queda atascado con el teclado.