Addaw, ir a inicio Donar

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

  1. Comprobar que existe un control de la interfaz de usuario con un atributo aria-describedby que hace referencia a uno o más elementos mediante un id único.
  2. 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

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

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