Tècnica ARIA WCAG 2.2
ARIA15Descriure imatges complexes amb aria-describedby
Nom oficial al W3C: Utilitzar aria-describedby per proporcionar descripcions d'imatges
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
- Doneu a la imatge un
altcurt que digui què és. - Escriviu la descripció llarga a la pàgina, a prop de la imatge.
- Doneu a aquest text un
idúnic, per exempleid="desc-visitas". - Afegiu a la imatge
aria-describedby="desc-visitas". - Si la descripció està repartida en diversos elements, poseu-ne els
idseparats per espais. - El lector llegeix la descripció com un text seguit. Si hi ha moltes dades, poseu-les també en una taula visible.
Com comprovar-ho
- Cerqueu les imatges que tenen
aria-describedby. - Comproveu que cada
idindicat existeix a la pàgina. - Llegiu junts l'
alti la descripció. Entre tots dos han de transmetre el mateix que la imatge. - 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
- Examinar cada element d'imatge en què hi hagi un atribut
aria-describedby. - Examinar si l'atribut
aria-describedbyassocia per programari un element amb la seva descripció textual, a través de l'atributidde l'element en què es troba el text que s'utilitzarà com a descripció. - 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
- WAI-ARIA Authoring Practices Guide (guia de pràctiques d'autor de WAI-ARIA)
- HTML to Platform Accessibility APIs Implementation Guide: Accessible Name and Description Calculation (càlcul del nom i la descripció accessibles)
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.
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.