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

Error habitual WCAG 2.2

F38Imatges decoratives sense atribut alt

Nom oficial al W3C: Error del criteri de conformitat 1.1.1 per no marcar les imatges decoratives en HTML de manera que la tecnologia de suport les pugui ignorar

Versión en castellano

En poques paraules

L'error és deixar sense atribut alt una imatge que només decora, com una icona al costat d'un text que ja diu el mateix. Sense aquest atribut, el lector de pantalla no sap que la pot saltar i anuncia «gràfic» o el nom del fitxer. La solució és posar l'alt buit: alt="".

Per què és important

Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) intenta anunciar totes les imatges. Només se salta les que estan marcades com a decoratives.

  • Si falta l'alt, molts lectors llegeixen el nom del fitxer, com ara «icona-calendari punt svg». És soroll que no aporta res.
  • En un menú amb deu icones, la persona sent deu sorolls, un abans de cada opció. Navegar es torna lent i cansat.
  • Les eines de revisió automàtica també marquen aquestes imatges com a error.

Com evitar-ho

  1. Decidiu si cada imatge informa o només decora. Decora si, en treure-la, no es perd cap informació.
  2. A les decoratives, poseu-hi alt="": l'atribut present i buit, sense cap espai a dins.
  3. No traieu l'atribut. Per al lector de pantalla, no tenir alt i tenir alt="" no és el mateix.
  4. També serveix role="presentation". Però alt="" és més senzill i l'entenen més lectors.
  5. Si la imatge és només un adorn, penseu a posar-la com a fons amb CSS. Així no cal cap alt.

Exemple pràctic

Les icones que acompanyen un text que ja diu el mateix són decoratives. El lector de pantalla les ha de poder saltar. Exemple: la llista de tràmits destacats a la portada d'un ajuntament.

Així no: Icones decoratives sense atribut alt

Les icones són decoratives, perquè el text de l'enllaç ja ho diu tot. Però no tenen atribut alt ni role="presentation", així que el lector de pantalla no les pot saltar. Segons el lector, anuncia «gràfic», el nom del fitxer o l'adreça de la imatge abans de cada enllaç. Per notar-ho, recorreu la llista amb NVDA o VoiceOver.

Captura de pantalla de l'exemple incorrecte: Icones decoratives sense atribut alt
Així es veu l'exemple incorrecte.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.

Veure el codi de l'exemple incorrecte
<style>
  .tramites { list-style: none; padding: 0; margin: 0; }
  .tramites li { margin: 8px 0; }
  .tramites a { display: inline-flex; align-items: center; gap: 8px; color: #412c56; font-weight: bold; }
  .tramites a:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
</style>
<h2>Tràmits més sol·licitats</h2>
<ul class="tramites">
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24"> Cita prèvia</a></li>
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24"> Certificat d'empadronament</a></li>
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24"> Pagament de rebuts i impostos</a></li>
</ul>

Així sí: Icones decoratives amb alt buit

S'afegeix alt="" a cada icona. També serviria role="presentation", però l'alt buit és més senzill i compatible. Ara els lectors se salten les imatges i anuncien només el text de cada enllaç.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<style>
  .tramites { list-style: none; padding: 0; margin: 0; }
  .tramites li { margin: 8px 0; }
  .tramites a { display: inline-flex; align-items: center; gap: 8px; color: #412c56; font-weight: bold; }
  .tramites a:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
</style>
<h2>Tràmits més sol·licitats</h2>
<ul class="tramites">
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24" alt=""> Cita prèvia</a></li>
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24" alt=""> Certificat d'empadronament</a></li>
  <li><a href="#"><img src="data:image/svg+xml,…" width="24" height="24" alt=""> Pagament de rebuts i impostos</a></li>
</ul>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Recórrer els enllaços amb Tab. A NVDA, també amb la tecla K en mode d'exploració.
  2. Comprovar que només s'anuncia el text de cada enllaç. No s'han de sentir «gràfic», noms de fitxer ni rutes d'imatge.

Hauria d'anunciar: «Cita prèvia, enllaç», sense esmentar cap imatge

Eines del navegador

  1. Obrir les eines de desenvolupament (F12). A la consola, executar document.querySelectorAll('img:not([alt]):not([role=presentation]):not([role=none])'). Així es llisten les imatges sense alt ni rol de presentació.
  2. A l'arbre d'accessibilitat de Chrome, comprovar que les icones corregides apareixen com a ignorades. No han d'afegir res al nom de l'enllaç.

Validació automàtica

  1. axe DevTools ho detecta amb la regla image-alt. WAVE ho marca com a «Missing alternative text» o «Linked image missing alternative text». Les imatges sense alt són fàcils de trobar de manera automàtica.
  2. El que no decideixen és si la imatge és decorativa o informativa. Si és decorativa, es corregeix amb alt=""; si informa, necessita un text. Aquesta decisió és manual.

Errors freqüents en auditories

  • Icones sense alt inserides com a img dins d'enllaços o botons que ja tenen text.
  • Separadors, fons o adorns posats amb img i sense alt, en lloc de fer-ho amb CSS (background-image).
  • Creure que no posar l'alt equival a alt="". Sense l'atribut, molts lectors anuncien el nom del fitxer.
  • Plantilles o components de tercers que creen imatges decoratives sense alt i que ningú no revisa.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica F38 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

HTML

Descripció

Aquest document descriu una condició d'error relativa a les alternatives textuals d'imatges que la tecnologia de suport hauria d'ignorar. Si no hi ha cap atribut alt, les tecnologies de suport no poden ignorar el contingut no textual. Per evitar un error d'aquest criteri de conformitat, l'atribut alt ha de ser present i tenir un valor nul (és a dir, alt="" ).

Aquest document descriu una condició d'error relativa a les alternatives textuals d'imatges que la tecnologia de suport (TS) hauria d'ignorar. Si una imatge té l'atribut role="presentation", la TS la ignorarà. No obstant això, si no té role="presentation" i no hi ha cap atribut alt, les tecnologies de suport no poden ignorar la imatge. En les imatges decoratives que la TS ha d'ignorar, per evitar un error d'aquest criteri de conformitat cal usar role="presentation" o bé incloure l'atribut alt amb un valor nul (és a dir, alt="").

Exemples

  • Imatges decoratives que no tenen atribut alt ni atribut role

Proves

Procediment

Per a cada element img que s'usi com a contingut purament decoratiu:

  1. Comprovar si l'element no té atribut role o té un atribut role amb un valor diferent de presentation.
  2. Comprovar si l'element no té atribut alt o té un atribut alt amb un valor que no és nul.

Resultats esperats

  • Si les comprovacions núm. 1 i núm. 2 són certes, es dona aquesta condició d'error i el contingut incompleix el criteri de conformitat.

Com ho comprovem a ADDAW

Aquest error és un dels que busquem en cada auditoria d'ADDAW. Us el lliurem amb captures i la manera de corregir-lo.

Sol·licitar una auditoria

Basat en la tècnica F38 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.