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

Error habitual WCAG 2.2

F30Textos alternatius que no substitueixen la imatge

Nom oficial al W3C: Error dels criteris de conformitat 1.1.1 i 1.2.1 per fer servir alternatives textuals que no són alternatives (p. ex., noms de fitxer o text de farciment)

Versión en castellano

En poques paraules

Aquest error es produeix quan una imatge té text alternatiu, però aquest text no serveix. Exemples: el nom del fitxer, «imatge», «foto 1» o un espai en blanc. Un text alternatiu ha de poder ocupar el lloc de la imatge sense que es perdi informació ni funció.

Per què és important

Les persones cegues fan servir un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla). Per a elles, el text alternatiu és la imatge.

  • Si senten «IMG_2045.jpg» o «imatge», no saben què mostra.
  • Si la imatge és un enllaç o un botó, no saben on porta ni què fa.
  • Les eines automàtiques no ho detecten, perquè l'atribut alt existeix.

Com evitar-ho

  1. Penseu què aporta la imatge en aquell lloc i escriviu això a l'alt.
  2. En gràfics, doneu les dades o la conclusió, no només el títol.
  3. En enllaços i botons amb imatge, descriviu la destinació o l'acció: «Descarregar l'informe (PDF)».
  4. Si la imatge és només decoració, deixeu l'alt="" buit, sense espai. Així el lector la ignora.
  5. Reviseu el gestor de continguts perquè no empleni l'alt amb el nom del fitxer.

Exemple pràctic

L'atribut alt existeix, però no serveix com a alternativa. És típic dels gestors de continguts que l'emplenen amb el nom del fitxer. Exemple: una notícia municipal amb un gràfic i un enllaç a un informe en PDF.

Així no: Nom de fitxer i text genèric com a alternativa

L'alt del gràfic és el nom del fitxer, i el de la icona de l'enllaç és «icona». El lector anuncia «grafico_vidrio_2025.png, gràfic» i «Descarregar l'informe anual icona, enllaç». No dona les dades del gràfic ni diu que l'enllaç descarrega un PDF. Les eines automàtiques no ho marquen, perquè l'alt existeix.

Captura de pantalla de l'exemple incorrecte: Nom de fitxer i text genèric com a alternativa
Així es veu l'exemple incorrecte.

La demostració conté, expressament, l'error d'accessibilitat que s'explica.

Veure el codi de l'exemple incorrecte
<style>
  .noticia { max-width: 420px; color: #0B2239; }
  .noticia h2 { font-size: 1.2rem; margin: 0 0 8px; }
  .noticia a { color: #412c56; }
  .noticia a:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
  .noticia a img { vertical-align: middle; }
</style>
<article class="noticia">
  <h2>El reciclatge de vidre puja un 12 % el 2025</h2>
  <img src="data:image/svg+xml,…" width="280" height="150" alt="grafico_vidrio_2025.png">
  <p>
    <a href="#">Descarregar l'informe anual <img src="data:image/svg+xml,…" width="20" height="24" alt="icona"></a>
  </p>
</article>

Així sí: Alternatives que substitueixen la imatge

L'alt del gràfic en recull les dades, i el de la icona indica el format del document. Ara cada text alternatiu substitueix la seva imatge sense perdre informació. És el que exigeix el criteri 1.1.1.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<style>
  .noticia { max-width: 420px; color: #0B2239; }
  .noticia h2 { font-size: 1.2rem; margin: 0 0 8px; }
  .noticia a { color: #412c56; }
  .noticia a:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
  .noticia a img { vertical-align: middle; }
</style>
<article class="noticia">
  <h2>El reciclatge de vidre puja un 12 % el 2025</h2>
  <img src="data:image/svg+xml,…" width="280" height="150" alt="Vidre recollit: 366 tones el 2024 i 410 tones el 2025">
  <p>
    <a href="#">Descarregar l'informe anual <img src="data:image/svg+xml,…" width="20" height="24" alt="(PDF)"></a>
  </p>
</article>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Recórrer la pàgina amb NVDA en mode d'exploració i prémer G per anar d'imatge en imatge. A VoiceOver, fer servir el rotor d'imatges.
  2. En cada imatge, valorar si el que se sent la podria substituir sense perdre informació. No serveixen noms de fitxer, «imatge», «foto 1», «icona» ni «bàner».

Hauria d'anunciar: «Vidre recollit: 366 tones el 2024 i 410 tones el 2025, gràfic» i «Descarregar l'informe anual (PDF), enllaç»

Eines del navegador

  1. Obrir les eines de desenvolupament (F12). A la consola, llistar els textos alternatius amb [...document.images].map(i => i.alt).
  2. Buscar valors amb extensions (.jpg, .png, .svg), guions baixos, números o paraules genèriques. Comparar cadascun amb el que mostra la imatge.

Validació automàtica

  1. La regla image-alt d'axe DevTools (i de Lighthouse, que la fa servir) només comprova que hi hagi alternativa, no que sigui adequada. Aquest cas passa sense error.
  2. WAVE mostra l'alerta «Suspicious alternative text» amb alguns valors sospitosos, com noms de fitxer, «image» o «graphic». Però no valora si el text és equivalent: la decisió final és sempre manual.

Errors freqüents en auditories

  • Gestors de continguts que emplenen l'alt amb el nom del fitxer pujat (IMG_2045.jpg, banner-home-v3.png).
  • Textos genèrics com «imatge», «foto», «icona» o «logo», posats només perquè l'eina automàtica no doni error.
  • Gràfics i infografies l'alt dels quals és només el títol («Gràfic de reciclatge»), sense les dades ni la conclusió.
  • Galeries amb alternatives numerades («Foto 1», «Foto 2») que no diuen què mostra cada imatge.
Veure el text complet del W3C (traducció al català)

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

S'aplica a totes les tecnologies.

Descripció

Aquesta tècnica descriu una condició d'error per a totes les tècniques que impliquen alternatives textuals. Si el text de l'«alternativa textual» no es pot fer servir en lloc del contingut no textual sense perdre informació o funcionalitat, aleshores no compleix, perquè en realitat no és una alternativa del contingut no textual.

Exemples

Alguns exemples de textos que no són alternatives textuals:

  • textos de farciment com " " (un espai), "spacer" (separador), "image" (imatge) o "picture" (fotografia), etc., col·locats en el lloc de l'«alternativa textual» d'imatges o fotografies.
  • referències de programació que no transmeten la informació ni la funció del contingut no textual, com ara "picture 1", "picture 2" o "0001", "0002" o "Intro#1", "Intro#2".
  • noms de fitxer que no són alternatives textuals vàlides per si mateixos, com ara "Oct.jpg", "Chart.jpg" o "sales\\oct\\top3.jpg"

Proves

Procediment

  1. Comprovar cada alternativa textual per veure si en realitat no és una alternativa textual del contingut no textual.

Resultats esperats

  • Si la comprovació núm. 1 és vertadera, es dona aquesta condició d'error i el contingut no compleix 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 F30 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.