Addaw, ir a inicio Donar

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:

  1. 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.
  2. 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

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.

Solicitar una auditoría

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.

Financiado por la unión europea Gobierno de españa red.es Plan de recuperación transformación y resilencia kit digital