# tabindex: uso correcto de 0, -1 y valores positivos

Source: https://allyway.ai/es/glossary/tabindex

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](https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html), 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](https://allyway.ai/es/glossary/orden-del-foco).

> **Warning:** > **Un solo valor positivo afecta a toda la página**
> Un único `tabindex="1"` en un campo de boletín del pie de página lo convierte en la primera parada tras la barra de direcciones del navegador, antes del logotipo, del menú y de su [enlace de salto](https://allyway.ai/es/glossary/enlace-de-salto). Todos los elementos con un tabindex positivo se visitan primero y después el resto de la página.

A quién afecta: a las personas que usan la [navegación por teclado](https://allyway.ai/es/glossary/navegacion-por-teclado), a los usuarios de [lector de pantalla](https://allyway.ai/es/glossary/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:

```html title="Ejemplo"
<!-- 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](https://allyway.ai/es/glossary/dialogo-modal-accesible).

**Do:** Qué hacer

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](https://allyway.ai/es/glossary/foco-visible).

**Don't:** Qué evitar

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

Q: ¿Qué diferencia hay entre tabindex 0 y -1?
A: `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.

Q: ¿Por qué debo evitar los valores positivos de tabindex?
A: 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.

Q: ¿Necesitan tabindex los botones y los enlaces?
A: 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.

Q: ¿Qué leyes exigen un orden de tabulación correcto?
A: 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](https://allyway.ai/es/regulations/eaa).

Q: ¿Puede allyWay corregir tabindex automáticamente?
A: 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](https://app.allyway.ai/register) y consiga un orden de tabulación lógico en todas las páginas.
