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

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

Versión en castellano

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

  1. 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 és alt.
  2. Agrupeu les peces en un contenidor amb role="img". Així el conjunt es presenta com una sola imatge.
  3. Poseu un id únic al text visible que descriu la imatge.
  4. Afegiu al contenidor aria-labelledby amb aquest id.
  5. Comproveu que el text transmet el mateix que la imatge: la dada o la funció, no l'aspecte.

Com comprovar-ho

  1. Cerqueu els elements amb aria-labelledby que representen imatges o gràfics.
  2. Comproveu que l'id indicat existeix a la pàgina.
  3. Llegiu el text a què apunta i confirmeu que transmet la mateixa informació que la imatge.
  4. 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

  1. Examinar cada element en què hi hagi l'atribut aria-labelledby i que no admeti l'atribut alt.
  2. Comprovar si el valor de l'atribut aria-labelledby és l'id d'un element de la pàgina web.
  3. Determinar que el text de l'element identificat per l'atribut aria-labelledby etiqueta 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

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