Técnica ARIA WCAG 2.2
ARIA1Usar la propiedad aria-describedby para proporcionar una etiqueta descriptiva a los controles de la interfaz de usuario
En resumen
Esta técnica explica cómo asociar a un control (un campo de formulario, un botón...) información adicional ya presente en la página mediante aria-describedby, de modo que los lectores de pantalla la anuncien junto con su etiqueta. Es útil cuando las instrucciones o aclaraciones están visibles pero no vinculadas al control por software, y beneficia sobre todo a quienes navegan con tecnologías de asistencia.
Aplicabilidad
Tecnologías compatibles con Accessible Rich Internet Applications (WAI-ARIA).
Descripción
El propósito de esta técnica es mostrar cómo usar la propiedad aria-describedby de WAI-ARIA para proporcionar información descriptiva, determinable por software, sobre un elemento de la interfaz de usuario. La propiedad aria-describedby puede utilizarse para vincular información descriptiva a uno o más elementos mediante una lista de referencias de id. La lista de referencias de id contiene uno o más id únicos de elementos.
Consulte ARIA in HTML para obtener información sobre cómo proporcionar estados y propiedades de WAI-ARIA con HTML. Los estados y propiedades de WAI-ARIA también son compatibles con otros lenguajes; consulte la documentación de dichos lenguajes.
La propiedad aria-describedby no está diseñada para hacer referencia a descripciones situadas en un recurso externo: como se trata de un id, debe hacer referencia a un elemento del mismo documento DOM.
Ejemplos
Usar aria-describedby para asociar instrucciones a campos de formulario
Ejemplo de campo de formulario que usa aria-describedby para asociar instrucciones a los campos de formulario cuando ya existe una etiqueta de formulario.
<form>
<label for="fname">First name</label>
<input aria-describedby="int2" autocomplete="given-name" id="fname" type="text">
<p id="int2">Your first name is sometimes called your "given name".</p>
</form>
Usar la propiedad aria-describedby para proporcionar información más detallada sobre el botón
<div>
<span id="fontDesc">Select the font faces and sizes to be used on this page</span>
<button aria-describedby="fontDesc" id="fontB" type="button">Fonts</button>
</div>
<div>
<span id="colorDesc">Select the colors to be used on this page</span>
<button aria-describedby="colorDesc" id="colorB" type="button">Colors</button>
</div>
<div>
<span id="customDesc">Customize the layout and styles used on this page</span>
<button aria-describedby="customDesc" id="customB" type="button">Customize</button>
</div>
Pruebas
Procedimiento
- Comprobar que existe un control de la interfaz de usuario con un atributo
aria-describedbyque hace referencia a uno o más elementos mediante unidúnico. - Comprobar que el elemento o elementos referenciados proporcionan información adicional sobre el control de la interfaz de usuario.
Resultados esperados
- Las comprobaciones n.º 1 y n.º 2 son verdaderas.
Recursos
- WAI-ARIA Overview (introducción a WAI-ARIA).
- WAI-ARIA Authoring Practices Guide (guía de prácticas de autor de WAI-ARIA).
- HTML Accessibility API Mappings
- Accessible Name and Description Computation (cálculo del nombre y la descripción accesibles).
-
Atributo
aria-describedby(MDN). - Using WAI-ARIA in HTML (uso de WAI-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 ARIA1 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.