Addaw, anar a la pàgina d'inici Donar

Tècnica ARIA WCAG 2.2

ARIA15Descriure imatges complexes amb aria-describedby

Nom oficial al W3C: Utilitzar aria-describedby per proporcionar descripcions d'imatges

Versión en castellano

En poques paraules

Algunes imatges, com ara un gràfic o un plànol, necessiten més explicació de la que cap al text alternatiu. Amb aria-describedby s'enllaça la imatge amb un text de la mateixa pàgina que la descriu a fons. El lector de pantalla llegeix primer el nom curt i després aquesta descripció.

Per què és important

L'atribut alt ha de ser breu: «Gràfic de visites al museu el 2025». Però una persona cega també necessita les dades que mostra el gràfic.

Si la descripció és a la mateixa pàgina, serveix a tothom: a qui utilitza lector de pantalla, a qui hi veu malament i a qui no entén bé el gràfic. A més, aria-describedby deixa clar quin text descriu cada imatge.

Com es fa

  1. Doneu a la imatge un alt curt que digui què és.
  2. Escriviu la descripció llarga a la pàgina, a prop de la imatge.
  3. Doneu a aquest text un id únic, per exemple id="desc-visitas".
  4. Afegiu a la imatge aria-describedby="desc-visitas".
  5. Si la descripció està repartida en diversos elements, poseu-ne els id separats per espais.
  6. El lector llegeix la descripció com un text seguit. Si hi ha moltes dades, poseu-les també en una taula visible.

Com comprovar-ho

  1. Cerqueu les imatges que tenen aria-describedby.
  2. Comproveu que cada id indicat existeix a la pàgina.
  3. Llegiu junts l'alt i la descripció. Entre tots dos han de transmetre el mateix que la imatge.
  4. Amb un lector de pantalla, situeu-vos a la imatge. Ha de llegir el nom curt i després la descripció.

Exemple

Gràfic de barres amb la seva descripció en un paràgraf visible a sota.

<img src="visitas-2025.png" alt="Gràfic de visites al museu el 2025"
     aria-describedby="desc-visitas">
<p id="desc-visitas">
  Les visites creixen de gener (1.200) a agost (4.800), el punt més alt.
  Després baixen fins a 1.500 al desembre.
</p>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA15 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Tecnologies que admeten Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és proporcionar descripcions de les imatges quan una alternativa textual curta no transmet adequadament la funció o la informació que ofereix l'objecte.

Una de les característiques de WAI-ARIA és la possibilitat d'associar un text descriptiu a una secció, un dibuix, un element de formulari, una fotografia, etc., mitjançant la propietat aria-describedby. El text descriptiu proporcionat amb aria-describedby és independent del nom curt proporcionat amb l'atribut alt d'HTML. Un avantatge de proporcionar descripcions llargues utilitzant contingut de la mateixa pàgina en què és la imatge és que l'alternativa queda disponible per a tothom, incloses les persones vidents que no disposen de tecnologies de suport.

Igual que aria-labelledby, aria-describedby pot acceptar diversos id per apuntar a altres zones de la pàgina mitjançant una llista separada per espais. També està limitat a id per definir aquests conjunts.

Exemples

Descriure una imatge

L'exemple següent mostra com es pot aplicar aria-describedby a una imatge per proporcionar una descripció llarga, quan aquesta descripció textual és a la mateixa pàgina que la imatge.

<img src="ladymacbeth.jpg" alt="Lady MacBeth" aria-describedby="p1">
<p id="p1">This painting dates back to 1889 and is oil on canvas. It was created by 
 John Singer Sargent, and represents ...</p>

Proves

Procediment

  1. Examinar cada element d'imatge en què hi hagi un atribut aria-describedby.
  2. Examinar si l'atribut aria-describedby associa per programari un element amb la seva descripció textual, a través de l'atribut id de l'element en què es troba el text que s'utilitzarà com a descripció.
  3. Examinar si la combinació de l'equivalent textual i la descripció textual associada descriu amb precisió l'objecte o en proporciona el propòsit equivalent.

Resultats esperats

  • Les comprovacions núm. 1, núm. 2 i núm. 3 són certes.

Recursos

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica ARIA15 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.