# Pestañas accesibles: roles ARIA y teclas de flecha

Source: https://allyway.ai/es/glossary/pestanas-accesibles

Las pestañas accesibles son una interfaz de pestañas cuyas pestañas se exponen como una lista de pestañas con estado de selección, se manejan con el teclado y están conectadas con el panel que muestran. Entran en el criterio WCAG 4.1.2 Nombre, función, valor, de nivel A, porque los widgets de pestañas personalizados deben comunicar su rol y su estado a las tecnologías de apoyo.

Las pestañas accesibles son interfaces de pestañas, como detalles de producto, tablas de precios o páginas de ajustes, que todos los visitantes pueden usar y no solo quienes tienen ratón. Muchos widgets de pestañas se crean con `div`s y controladores de clic: parecen pestañas, pero un lector de pantalla anuncia texto sin más, el teclado no puede llegar a ellas y nadie oye qué pestaña está abierta. Un panel de pestañas accesible necesita los roles correctos, un estado de selección y un patrón de teclado previsible.

## Qué significa

HTML no tiene un elemento de pestañas nativo, así que todo widget de pestañas es un componente personalizado. Eso lo sitúa bajo el criterio [WCAG 4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (nivel A): en los componentes con script, el [nombre, la función y el valor](https://allyway.ai/es/glossary/nombre-funcion-valor) deben poder determinarse por software y los cambios de estado deben estar disponibles para las tecnologías de apoyo. El [patrón de pestañas](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/) del W3C, en la guía WAI-ARIA Authoring Practices, describe cómo hacerlo:

| Elemento | Rol y atributos |
|---|---|
| Contenedor de las pestañas | `role="tablist"`, con una etiqueta mediante `aria-label` o `aria-labelledby` |
| Cada pestaña | `role="tab"`, `aria-selected="true"` en la activa y `false` en las demás, `aria-controls` que apunta a su panel |
| Cada panel | `role="tabpanel"`, `aria-labelledby` que apunta a su pestaña |
| Lista de pestañas vertical | `aria-orientation="vertical"` (la horizontal es la predeterminada) |

El patrón de teclado:

| Tecla | Qué ocurre |
|---|---|
| Tab | Lleva el foco a la pestaña activa y después, fuera de la lista de pestañas, al panel |
| Flecha izquierda / derecha | Se mueve entre pestañas, pasando de la última a la primera |
| Inicio / Fin (opcional) | Salta a la primera o a la última pestaña |
| Intro / Espacio | Activa la pestaña que tiene el foco si las pestañas no se activan automáticamente |

Solo la pestaña activa está en el orden de Tab (`tabindex="0"`); las demás reciben `tabindex="-1"` y las teclas de flecha se mueven entre ellas. Es la técnica del «tabindex itinerante» (roving tabindex) que se describe en [tabindex](https://allyway.ai/es/glossary/tabindex).

> **Tip:** > **¿Activación automática o manual?**
> El W3C recomienda mostrar un panel en cuanto su pestaña recibe el foco solo si el panel aparece sin un retraso apreciable. Si los paneles cargan contenido del servidor, deje que los usuarios confirmen con Intro o Espacio.

## Ejemplos

```html title="Ejemplo"
<div role="tablist" aria-label="Product information">
  <button role="tab" id="tab-1" aria-selected="true"
          aria-controls="panel-1" tabindex="0">Description</button>
  <button role="tab" id="tab-2" aria-selected="false"
          aria-controls="panel-2" tabindex="-1">Sizes</button>
  <button role="tab" id="tab-3" aria-selected="false"
          aria-controls="panel-3" tabindex="-1">Reviews</button>
</div>

<div role="tabpanel" id="panel-1" aria-labelledby="tab-1" tabindex="0">
  <p>Hand-knitted wool scarf, 180 cm long.</p>
</div>
<div role="tabpanel" id="panel-2" aria-labelledby="tab-2" tabindex="0" hidden>…</div>
<div role="tabpanel" id="panel-3" aria-labelledby="tab-3" tabindex="0" hidden>…</div>
```

Ahora un lector de pantalla anuncia algo como «Product information, lista de pestañas, Description, pestaña, seleccionada, 1 de 3». El script cambia `aria-selected`, `tabindex` y `hidden` cuando se elige otra pestaña. Usar elementos `<button>` da a las pestañas una base de [navegación por teclado](https://allyway.ai/es/glossary/navegacion-por-teclado) incluso antes de que se ejecute el script.

**Do:** Qué hacer

Use `tablist`, `tab` y `tabpanel`, mantenga `aria-selected` sincronizado, permita usar las teclas de flecha, conserve un contorno de foco bien visible en la pestaña activa y dé una etiqueta a la lista de pestañas.

**Don't:** Qué evitar

Crear pestañas con enlaces que recargan la página aunque finjan ser pestañas, poner `role="tab"` en un elemento de lista que envuelve el enlace real, dejar todas las pestañas en el orden de Tab sin teclas de flecha, o mostrar la pestaña activa solo mediante el color.

## Cómo comprobar unas pestañas accesibles



## Preguntas frecuentes

Q: ¿Cómo se hacen accesibles las pestañas?
A: Dé al contenedor `role="tablist"`, a cada pestaña `role="tab"` con `aria-selected` y `aria-controls`, y a cada panel `role="tabpanel"`. Después añada la navegación con las teclas de flecha y deje en el orden de Tab solo la pestaña activa.

Q: ¿Deben cambiar de pestaña las teclas de flecha o la tecla Tab?
A: Las teclas de flecha se mueven entre pestañas; la tecla Tab entra en la lista de pestañas y sale de ella. Es el patrón de la guía WAI-ARIA Authoring Practices del W3C y lo que esperan los usuarios de lector de pantalla.

Q: ¿Las pestañas necesitan aria-controls?
A: El patrón del W3C pone `aria-controls` en cada pestaña, apuntando a su panel, y `aria-labelledby` en el panel, apuntando de vuelta a la pestaña. Juntos indican a la tecnología de apoyo qué pestaña muestra qué contenido.

Q: ¿Son malas las pestañas para la accesibilidad?
A: No, si siguen el patrón. Los problemas vienen de los widgets personalizados sin roles ni estados. Si el contenido es corto, unos encabezados sencillos o un acordeón pueden ser más fáciles para todos.

Q: ¿Qué criterio WCAG se aplica a las pestañas?
A: Principalmente el 4.1.2 Nombre, función, valor, además del 2.1.1 Teclado y el 2.4.7 Foco visible, todos ellos parte de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2).
