Código de la tecla Tab (tabulador)

Tab envía event.key "Tab", event.code "Tab" y keyCode 9, con o sin Mayús.

Todos los valores de un vistazo

Valores de Tabulador
Teclaevent.codeevent.keykeyCodeevent.location
TabTabTab90 (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 Tabulador

¿Usas solo el teclado? Pulsa Esc y luego Tab para salir del cuadro de teclas.

Código para reaccionar a Tabulador

Recomendado: reconocer por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Tab') {
    // Tu código aquí
  }
});
Reconocer el lugar de la tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Tab') {
    // Tu código aquí
  }
});
Código antiguo que aún usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 9) {
    // Tu código aquí
  }
});

Qué valor usar

Comprueba event.key === 'Tab'. Hay una sola tecla Tab, y envía el mismo valor en todas las distribuciones. event.code también es "Tab".

Mayús + Tab sigue enviando "Tab": Mayús no cambia el nombre de la tecla. Comprueba event.shiftKey para saber si también se ha pulsado Mayús.

keyCode 9 sigue llegando en todos los navegadores, pero está obsoleto.

Qué suele salir mal

El keyup llega a otro elemento

Tab mueve el foco en keydown. Así, el keydown va al campo que dejas y el keyup va al campo al que llegas. Un controlador de keyup en un campo ve Tab cada vez que alguien llega a él con el tabulador. Gestiona Tab en keydown.

Quien usa el teclado no puede salir de mi componente

Si llamas a preventDefault() en Tab, el foco nunca se mueve y quien usa el teclado no puede salir. Sin otra salida, eso incumple el criterio 2.1.2 de las WCAG, Sin trampas para el foco del teclado. Frena Tab solo por una buena razón, como un cuadro de diálogo modal que mantiene el foco dentro mientras está abierto. Y da una salida clara: Esc, o un botón de cerrar.

En mi textarea, Tab pasa al siguiente campo en vez de insertar una sangría

Es el comportamiento por defecto, y la mayoría lo quiere así. En un editor de código puedes insertar un carácter de tabulación:

if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}

Combínalo con una salida, como hace el buscador: pulsa Esc primero y Tab sigue adelante. setRangeText() no añade nada al historial de deshacer; document.execCommand('insertText', false, '\t') sí, aunque está obsoleto.

Ctrl+Tab y Alt+Tab nunca llegan a la página

El navegador y el ordenador se los quedan: Ctrl + Tab cambia de pestaña del navegador, Alt + Tab (Comando + Tab en un Mac) cambia de aplicación. Tu página puede ver el keydown de Ctrl o Alt y luego nada. Cuando la persona vuelve, un modificador puede parecer atascado porque su keyup fue a otra ventana. Reinicia el estado de los modificadores con el evento blur de la ventana.

En Safari, Tab se salta enlaces y botones

Por defecto, Safari en un Mac se mueve solo entre campos de formulario. Opción + Tabulador llega a todos los elementos. También puedes activar “Pulsar Tabulador para resaltar cada ítem de una página web” en el panel Avanzado de los ajustes de Safari. Prueba el orden de tabulación con eso activado, y no des por hecho que quien usa Mac llega a un botón solo con Tab.

Orden de tabulación

Tab sigue el orden de los elementos en el HTML. tabindex="0" añade un elemento a ese orden y tabindex="-1" lo quita. Evita los valores positivos de tabindex. Hacen que esos elementos reciban el foco antes que los demás, y eso confunde a la gente.