tabindex: uso correcto de 0, -1 y valores positivos
También llamado: Índice de tabulación, Atributo tabindex, Orden de tabulación
Definición
tabindex es un atributo HTML que hace que un elemento pueda recibir el foco y fija su lugar en el orden de tabulación del teclado. 0 sigue el orden del código, -1 permite el foco solo por script y los valores positivos se adelantan a todo lo demás.
tabindex es un atributo HTML que decide si un elemento puede recibir el foco del teclado y qué lugar ocupa en el orden de Tab. Con 0 y -1 es una herramienta útil para controles personalizados y para gestionar el foco. Con números positivos, reordena en silencio toda la página para las personas que usan el teclado.
Qué significa
Los enlaces, los botones y los campos de formulario reciben el foco por defecto, en el orden en que aparecen en el código fuente. El atributo tabindex cambia ese comportamiento:
| Valor | Efecto | Uso típico |
|---|---|---|
| ninguno | Comportamiento de foco nativo | Enlaces, botones, campos: no hay que añadir nada |
tabindex="0" |
Recibe el foco, en el orden del código | Un control personalizado o una región con scroll a la que hay que poder llegar |
tabindex="-1" |
Recibe el foco solo por script o clic; Tab lo salta | El encabezado de un diálogo o un resumen de errores al que se mueve el foco |
tabindex="1" o superior |
Recibe el foco antes que todos los demás elementos, en orden numérico ascendente | Casi nunca: rompe el orden natural |
La regla que lo respalda es el criterio WCAG 2.4.3 Orden del foco, de nivel A: si una página se puede recorrer de forma secuencial y la secuencia afecta al significado o al funcionamiento, los componentes que reciben el foco deben hacerlo en un orden que conserve el significado y la operabilidad. El W3C recoge el fallo F44: usar tabindex para crear un orden de tabulación que no conserva el significado ni la operabilidad. La alternativa recomendada es la técnica C27: hacer que el orden del DOM coincida con el orden visual, de modo que no haga falta ningún tabindex. Encontrará más información sobre el propio orden del foco.
A quién afecta: a las personas que usan la navegación por teclado, a los usuarios de lector de pantalla que se desplazan por los controles y a las personas con pulsadores. Un orden de tabulación incorrecto hace que se salten campos, pierdan el contexto o rellenen los formularios en la secuencia equivocada.
Ejemplos
Un interruptor personalizado que necesita tabindex="0", el encabezado de un diálogo que recibe el foco por script y el valor positivo que conviene evitar:
<!-- Custom control: reachable in source order -->
<div role="switch" aria-checked="false" tabindex="0">Dark theme</div>
<!-- Focus target for script, not a Tab stop -->
<h2 id="dialog-title" tabindex="-1">Confirm your order</h2>
<script>document.getElementById('dialog-title').focus();</script>
<!-- Avoid: jumps ahead of everything else on the page -->
<input type="email" name="newsletter" tabindex="3">Cuando el foco se mueve a un diálogo, debe quedarse allí hasta que el diálogo se cierre; vea el diálogo modal accesible.
Use primero los elementos nativos: reciben el foco sin tabindex. Use tabindex="0" para controles personalizados y zonas con scroll, y tabindex="-1" para elementos a los que mueve el foco por script. Corrija los problemas de maquetación en el orden del código. Dé a cada elemento que recibe el foco un indicador de foco visible.
Usar valores positivos para «corregir» una maquetación. Poner tabindex="0" en texto normal o en encabezados que no son interactivos: añade paradas de Tab inútiles. Dar tabindex="-1" a un elemento que parece pulsable y dejarlo fuera del flujo del teclado.
Cómo comprobar tabindex
Preguntas frecuentes
¿Qué diferencia hay entre tabindex 0 y -1?
tabindex="0" coloca un elemento en la secuencia normal de Tab, en su lugar del código fuente. tabindex="-1" hace que reciba el foco por script o con un clic del ratón, pero la tecla Tab lo salta; es útil para encabezados o mensajes a los que se mueve el foco.
¿Por qué debo evitar los valores positivos de tabindex?
Los elementos con un tabindex positivo reciben el foco antes que todos los demás, en orden numérico, estén donde estén en la página. Esto crea fácilmente un orden que no conserva el significado, el fallo que el W3C describe como F44 para el criterio WCAG 2.4.3.
¿Necesitan tabindex los botones y los enlaces?
No. Los enlaces nativos con href, los botones y los campos de formulario ya reciben el foco en el orden del código. Añadirles tabindex="0" no cambia nada; añadirles un valor positivo empeora el orden.
¿Qué leyes exigen un orden de tabulación correcto?
El 2.4.3 es un criterio de nivel A, por lo que forma parte de toda norma basada en las WCAG AA, incluida la cláusula 9.2.4.3 de la norma EN 301 549, en la que se apoya la Ley Europea de Accesibilidad.
¿Puede allyWay corregir tabindex automáticamente?
Sí. allyWay pone a 0 todo tabindex superior a 0, de modo que la tecla Tab vuelve a seguir el orden de la página. Es gratis, no consume correcciones con IA y no requiere cambios en su código ni en su tema. Antes de que la corrección se publique, allyWay la prueba en su página real y solo la aplica cuando no cambia nada de lo que ven los visitantes; puede deshacerla con un clic. Empiece gratis y consiga un orden de tabulación lógico en todas las páginas.
Términos relacionados
Orden del foco: orden de tabulación lógico (WCAG 2.4.3)
El orden del foco es la secuencia en la que los elementos interactivos reciben el foco del teclado cuando el usuario pulsa Tab. El criterio WCAG 2.4.3 exige que esta secuencia preserve el significado y la operabilidad de la página.
Leer la definición: Orden del foco: orden de tabulación lógico (WCAG 2.4.3)Navegación por teclado: criterio WCAG 2.1.1 explicado
La navegación por teclado significa que todas las funciones de un sitio web se pueden alcanzar y utilizar solo con un teclado, normalmente con Tab, Mayús+Tab, Intro, Espacio y las teclas de flecha. El criterio WCAG 2.1.1 lo exige en el nivel A.
Leer la definición: Navegación por teclado: criterio WCAG 2.1.1 explicadoFoco visible: WCAG 2.4.7 y estilos de foco visibles
Foco visible significa que un sitio web muestra un indicador visible, normalmente un contorno, en el enlace, el botón o el campo que tiene el foco del teclado. El criterio WCAG 2.4.7 lo exige en el nivel AA.
Leer la definición: Foco visible: WCAG 2.4.7 y estilos de foco visiblesDiálogo modal accesible: foco, Escape y ARIA
Un diálogo modal accesible es una ventana emergente que los usuarios de teclado y de lector de pantalla pueden utilizar igual que los demás: el foco pasa a ella al abrirse, la página de fondo queda inerte, Escape la cierra y el foco vuelve al control que la abrió. Su gestión del foco entra en el criterio WCAG 2.4.3 Orden del foco, de nivel A.
Leer la definición: Diálogo modal accesible: foco, Escape y ARIA