# ARIA: roles, estados y propiedades explicados

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

ARIA (WAI-ARIA, Accessible Rich Internet Applications) es una especificación del W3C de atributos HTML (roles, estados y propiedades) que indican a las tecnologías de apoyo qué es un elemento personalizado, cómo se llama y en qué estado se encuentra.

ARIA, forma abreviada de WAI-ARIA (Accessible Rich Internet Applications), es un estándar del W3C que añade significado al HTML para las tecnologías de apoyo. Con los atributos ARIA, un [panel de pestañas](https://allyway.ai/es/glossary/pestanas-accesibles), un [acordeón](https://allyway.ai/es/glossary/acordeon-accesible) o un menú personalizados pueden indicar a un lector de pantalla qué son («pestaña»), cómo se llaman y si están abiertos o seleccionados. ARIA solo cambia lo que perciben las tecnologías de apoyo, no el aspecto ni el comportamiento de un elemento.

## Qué significa

ARIA tiene tres tipos de atributos:

| Tipo | Finalidad | Ejemplos |
|---|---|---|
| Roles | Qué es un elemento | `role="tab"`, `role="dialog"`, `role="navigation"` |
| Estados | Condiciones que cambian con el uso | `aria-expanded`, `aria-checked`, `aria-pressed` |
| Propiedades | Nombres, descripciones y relaciones | `aria-label`, `aria-labelledby`, `aria-describedby`, `aria-controls` |

[WCAG 4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html), un criterio de nivel A de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2), exige que el nombre, el rol, los estados y los valores de todo componente de la interfaz de usuario estén disponibles para las tecnologías de apoyo. Según el W3C, los controles HTML estándar ya lo cumplen cuando se usan conforme a la especificación. Los controles personalizados requieren trabajo adicional, y ARIA es la forma de hacerlo: la técnica ARIA4 expone el rol, la ARIA5 el estado y la ARIA14 y la ARIA16 el nombre. Un `div` convertido en control mediante un script sin un rol es el fallo F59.

> **Warning:** > **Primero, HTML nativo**
> La guía del W3C «Using ARIA» establece como primera regla que, si existe un elemento HTML nativo con el comportamiento que necesita, lo utilice en lugar de añadir un rol. `role="button"` en un `div` no aporta compatibilidad con el teclado: usted mismo tiene que añadir el foco con Tab y las teclas Intro y Espacio. Un `<button>` de verdad lo trae todo integrado.

Usar ARIA de forma incorrecta es peor que no usarlo: un rol mal escrito, un `aria-hidden="true"` en un elemento con el foco o un `aria-expanded` que nunca se actualiza envían información errónea a los usuarios de lectores de pantalla.

## Ejemplos

```html title="Ejemplo"
<!-- Accordion button: native button + state -->
<button aria-expanded="false" aria-controls="faq-1">Shipping costs</button>
<div id="faq-1" hidden>Shipping is free from 50 euros.</div>

<!-- Landmark with a name -->
<nav aria-label="Main">…</nav>

<!-- Don't: fake button without keyboard support -->
<div role="button" onclick="save()">Save</div>
```

Cuando se abre el acordeón, el script debe establecer `aria-expanded="true"` y quitar `hidden`: el estado tiene que seguir lo que se ve en pantalla.

**Do:** Qué hacer

Utilice primero elementos nativos y añada ARIA solo para lo que el HTML no puede expresar: estados como `aria-expanded`, nombres mediante [aria-label](https://allyway.ai/es/glossary/aria-label) y zonas de la página mediante [regiones ARIA (landmarks)](https://allyway.ai/es/glossary/regiones-aria). Mantenga cada estado sincronizado con la interfaz. Siga los patrones de la [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/).

**Don't:** Qué evitar

Añadir `role="button"` o `role="link"` a elementos que deberían ser botones o enlaces reales, usar roles que no existen, repetir el rol nativo (`<button role="button">`) u ocultar contenido que puede recibir el foco con `aria-hidden="true"`.

## Cómo comprobar ARIA en su sitio web



## Preguntas frecuentes

Q: ¿Qué significa ARIA?
A: Accessible Rich Internet Applications. El nombre completo de la especificación del W3C es WAI-ARIA, por la Web Accessibility Initiative, que la publica.

Q: ¿Cuándo debo usar ARIA?
A: Cuando el HTML no tiene un elemento nativo para lo que está creando (pestañas, vistas de árbol, cuadros combinados) o para añadir un estado o un nombre que el HTML no puede expresar. Para botones, enlaces, campos de formulario y encabezados, utilice el elemento HTML.

Q: ¿ARIA cambia el aspecto o el funcionamiento de mi sitio web?
A: No. ARIA solo cambia lo que los navegadores transmiten a las tecnologías de apoyo. El comportamiento del teclado, el foco y los estados visuales siguen teniendo que crearse con HTML, CSS y JavaScript.

Q: ¿Exigen las WCAG usar ARIA?
A: No. Las WCAG exigen que el nombre, el rol y el valor estén disponibles; el HTML nativo suele proporcionarlos. ARIA es una de varias técnicas suficientes, sobre todo para componentes personalizados.

Q: ¿Cómo puedo encontrar errores de ARIA en mi sitio web?
A: Ejecute el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) en su página de inicio: la comprueba según las WCAG 2.2 AA, incluidos el nombre, el rol y el valor de sus controles.
