¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 4.1.2Nivel ARobusto

ARIA: roles, estados y propiedades explicados

También llamado: WAI-ARIA, Accessible Rich Internet Applications, Atributos ARIA

Definición

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, un acordeón 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, un criterio de nivel A de las 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.

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

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.

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 y zonas de la página mediante regiones ARIA (landmarks). Mantenga cada estado sincronizado con la interfaz. Siga los patrones de la ARIA Authoring Practices Guide.

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

    ¿Qué significa ARIA?

    Accessible Rich Internet Applications. El nombre completo de la especificación del W3C es WAI-ARIA, por la Web Accessibility Initiative, que la publica.

    ¿Cuándo debo usar ARIA?

    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.

    ¿ARIA cambia el aspecto o el funcionamiento de mi sitio web?

    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.

    ¿Exigen las WCAG usar ARIA?

    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.

    ¿Cómo puedo encontrar errores de ARIA en mi sitio web?

    Ejecute el comprobador WCAG gratuito 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.

    • aria-label: cómo nombrar correctamente los elementos

      aria-label es un atributo ARIA que define el nombre accesible de un elemento como una cadena de texto. Los lectores de pantalla anuncian ese nombre en lugar del contenido del elemento, por lo que se usa sobre todo en controles sin texto visible, como los botones de icono.

      Leer la definición: aria-label: cómo nombrar correctamente los elementos
    • Regiones ARIA (landmarks) para lectores de pantalla

      Las regiones ARIA (landmarks) son roles como banner, navigation, main y contentinfo que identifican las grandes regiones de una página. Los lectores de pantalla las enumeran y permiten ir directamente a cada región.

      Leer la definición: Regiones ARIA (landmarks) para lectores de pantalla
    • Nombre accesible: qué es y cómo se calcula

      El nombre accesible es el texto que los navegadores transmiten a las tecnologías de apoyo para identificar un elemento, por ejemplo las palabras que un lector de pantalla anuncia para un botón, un enlace o un campo de formulario. El criterio WCAG 4.1.2 exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software.

      Leer la definición: Nombre accesible: qué es y cómo se calcula
    • Lector de pantalla: cómo lee un sitio web y qué necesita

      Un lector de pantalla es un software de apoyo que lee en voz alta el contenido y los controles de la pantalla o los envía a una línea braille. Se basa en los nombres, los roles y los estados que un sitio web expone a través del árbol de accesibilidad del navegador.

      Leer la definición: Lector de pantalla: cómo lee un sitio web y qué necesita

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo