Tècnica ARIA WCAG 2.2
ARIA10Utilitzar un text visible com a alternativa d'una imatge amb aria-labelledby
Nom oficial al W3C: Utilitzar aria-labelledby per proporcionar una alternativa textual al contingut no textual
En poques paraules
Algunes imatges o gràfics ja tenen al costat un text visible que diu el mateix, com ara «Valoració: 4 de 5 estrelles» sota unes estrelles. Amb aria-labelledby, aquest text es converteix en l'alternativa de la imatge. El lector de pantalla el llegeix com a nom de la imatge i no cal escriure'l dues vegades.
Per què és important
Una persona cega no percep una filera d'estrelles, un gràfic o un grup d'icones. Necessita un text que transmeti el mateix.
Si aquest text ja és a la pàgina, copiar-lo en un alt obliga a mantenir dues versions. Amb el temps, una canvia i l'altra no. Amb aria-labelledby hi ha un únic text, visible per a tothom i llegit pel lector de pantalla.
Com es fa
- Utilitzeu-lo sobretot amb imatges formades per diverses peces o que no admeten
alt, com ara un grup d'icones o un<svg>. Per a una<img>senzilla, el més habitual ésalt. - Agrupeu les peces en un contenidor amb
role="img". Així el conjunt es presenta com una sola imatge. - Poseu un
idúnic al text visible que descriu la imatge. - Afegiu al contenidor
aria-labelledbyamb aquestid. - Comproveu que el text transmet el mateix que la imatge: la dada o la funció, no l'aspecte.
Com comprovar-ho
- Cerqueu els elements amb
aria-labelledbyque representen imatges o gràfics. - Comproveu que l'
idindicat existeix a la pàgina. - Llegiu el text a què apunta i confirmeu que transmet la mateixa informació que la imatge.
- Amb les eines del navegador (F12, tauler «Accessibilitat»), confirmeu que el rol és «img» i que el nom és aquest text.
Exemple
Valoració d'un producte feta amb cinc imatges d'estrelles.
<div role="img" aria-labelledby="nota">
<img src="estrella-llena.svg" alt="">
<img src="estrella-llena.svg" alt="">
<img src="estrella-llena.svg" alt="">
<img src="estrella-llena.svg" alt="">
<img src="estrella-vacia.svg" alt="">
</div>
<p id="nota">Valoració: 4 de 5 estrelles</p>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica ARIA10 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
Aquesta tècnica s'aplica a HTML amb Accessible Rich Internet Applications (WAI-ARIA).
Descripció
L'objectiu d'aquesta tècnica és proporcionar una descripció curta d'un element, que les tecnologies de suport puguin llegir, mitjançant l'atribut aria-labelledby. L'atribut aria-labelledby associa un element amb un text visible en un altre lloc de la pàgina utilitzant un valor de referència d'id que coincideix amb l'atribut id de l'element que fa d'etiqueta. Les tecnologies de suport, com ara els lectors de pantalla, utilitzen el text de l'element identificat pel valor de l'atribut aria-labelledby com a alternativa textual de l'element que porta l'atribut.
Exemples
Proporcionar una descripció curta per a un gràfic complex
Aquest exemple mostra com utilitzar l'atribut aria-labelledby per proporcionar una descripció textual curta d'un gràfic complex de només lectura amb un patró de valoració per estrelles; el gràfic està compost per diversos elements d'imatge. L'alternativa textual del gràfic és l'etiqueta visible a la pàgina sota el patró d'estrelles.
<div role="img" aria-labelledby="star-id">
<img src="fullstar.png" alt="">
<img src="fullstar.png" alt="">
<img src="fullstar.png" alt="">
<img src="fullstar.png" alt="">
<img src="emptystar.png" alt="">
</div>
<div id="star-id">4 of 5</div>
Exemple funcional: Proporcionar una descripció curta per a un gràfic complex.
Proves
Procediment
- Examinar cada element en què hi hagi l'atribut
aria-labelledbyi que no admeti l'atributalt. - Comprovar si el valor de l'atribut
aria-labelledbyés l'idd'un element de la pàgina web. - Determinar que el text de l'element identificat per l'atribut
aria-labelledbyetiqueta amb precisió l'element, en descriu el propòsit o proporciona informació equivalent.
Resultats esperats
- Les comprovacions 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 Accessibility API Mappings
- Accessible Name and Description Computation (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 ARIA10 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.