Técnica ARIA WCAG 2.2
ARIA4Usar un atributo role de WAI-ARIA para exponer la función de un componente de la interfaz de usuario
En resumen
Cuando se construyen componentes propios (barras de herramientas, árboles, botones hechos con div o img...), las tecnologías de asistencia no saben qué son ni cómo manejarlos. Esta técnica consiste en asignarles un atributo role con uno de los roles no abstractos de WAI-ARIA para que lectores de pantalla y otros productos de apoyo anuncien su función. Úsela siempre que cree widgets a medida sin elementos HTML nativos equivalentes.
Aplicabilidad
Tecnologías compatibles con Accessible Rich Internet Applications (WAI-ARIA).
Descripción
El objetivo de esta técnica es definir la función de un elemento usando el atributo role con uno de los valores no abstractos definidos en la definición de roles de WAI-ARIA. La especificación WAI-ARIA proporciona una descripción informativa de cada rol, de cómo se relaciona con otros roles y de los estados y propiedades de cada rol. Cuando las aplicaciones de internet enriquecidas definen nuevos componentes (widgets) de interfaz de usuario, exponer los roles permite a los usuarios entender el componente y cómo interactuar con él.
Ejemplos
Una barra de herramientas sencilla
Una barra de herramientas que contiene tres botones. El elemento div tiene el rol "toolbar" y los elementos img tienen el rol "button":
<div role="toolbar"
tabindex="0"
id="customToolbar"
onkeydown="return optionKeyEvent(event);"
onkeypress="return optionKeyEvent(event);"
onclick="return optionClickEvent(event);"
onblur="hideFocus()"
onfocus="showFocus()"
>
<img src="img/btn1.gif"
role="button"
tabindex="-1"
alt="Home"
id="b1"
title="Home">
<img src="img/btn2.gif"
role="button"
tabindex="-1"
alt="Refresh"
id="b2"
title="Refresh">
<img src="img/btn3.gif"
role="button"
tabindex="-1"
alt="Help"
id="b3"
title="Help">
</div>
El patrón de barra de herramientas (Toolbar Pattern) de la guía de prácticas de autor ofrece un ejemplo funcional de barra de herramientas.
Un componente de árbol
Un componente de árbol básico. Obsérvese el uso de los roles "tree", "treeitem" y "group" para identificar el árbol y su estructura. Este es un extracto simplificado del código:
<ul role="tree" tabindex="0">
<li role="treeitem">Birds</li>
<li role="treeitem">Cats
<ul role="group">
<li role="treeitem">Siamese</li>
<li role="treeitem">Tabby</li>
</ul>
</li>
<li role="treeitem">Dogs
<ul role="group">
<li role="treeitem">Small Breeds
<ul role="group">
<li role="treeitem">Chihuahua</li>
<li role="treeitem">Italian Greyhound</li>
<li role="treeitem">Japanese Chin</li>
</ul>
</li>
<li role="treeitem">Medium Breeds
<ul role="group">
<li role="treeitem">Beagle</li>
<li role="treeitem">Cocker Spaniel</li>
<li role="treeitem">Pit Bull</li>
</ul>
</li>
<li role="treeitem">Large Breeds
<ul role="group">
<li role="treeitem">Afghan</li>
<li role="treeitem">Great Dane</li>
<li role="treeitem">Mastiff</li>
</ul>
</li>
</ul>
</li>
</ul>
El patrón de vista en árbol (Tree View Pattern) de la guía de prácticas de autor ofrece un ejemplo funcional de árbol.
Pruebas
Procedimiento
Para un componente de la interfaz de usuario que usa el atributo role:
- Comprobar que el valor del atributo role es uno de los roles no abstractos de entre los valores definidos en la especificación WAI-ARIA.
- Comprobar que las características del componente de la interfaz de usuario se corresponden con la descripción del rol.
Resultados esperados
- Las comprobaciones n.º 1 y n.º 2 son verdaderas.
Recursos
- Accessible Rich Internet Applications (WAI-ARIA), Roles (sección sobre roles)
- Accessible Rich Internet Applications (WAI-ARIA), The Roles Model (el modelo de roles)
- HTML Accessibility API Mappings 1.0
- WAI-ARIA Authoring Practices Guide (guía de prácticas de autor de WAI-ARIA)
- Notes on using ARIA in HTML (notas sobre el uso de ARIA en HTML)
Cómo lo comprobamos en ADDAW
En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.
Fuente y licencia
Traducción al español, no oficial, realizada por ADDAW a partir de la técnica ARIA4 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.