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

Error habitual WCAG 2.2

F65Imatges i botons d'imatge sense text alternatiu

Nom oficial al W3C: Error del criteri de conformitat 1.1.1 per ometre l'atribut alt o l'alternativa textual en els elements img, area i input de tipus "image"

Versión en castellano

En poques paraules

Aquest error es produeix quan una imatge, un botó fet amb una imatge o una zona d'un mapa d'imatge no té cap text alternatiu. Sense aquest text, els lectors de pantalla no poden dir què és ni per a què serveix. Normalment es resol amb l'atribut alt.

Per què és important

Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) no veu la imatge. Només pot llegir el text que l'acompanya al codi.

Si no hi ha text, alguns lectors llegeixen el nom del fitxer, com ara «img_0034.png», i d'altres no diuen res. Si la imatge és un enllaç o un botó, la persona no sap on va ni què fa. És especialment greu en el logotip que porta a la portada o en la lupa del cercador.

Com evitar-ho

  1. Poseu un atribut alt a cada img, a cada input type="image" i a cada area d'un mapa d'imatge.
  2. Si la imatge és un enllaç o un botó, descriviu-ne la destinació o l'acció: «Cerca», «Inici».
  3. Si la imatge és només decorativa, utilitzeu alt="" (buit) perquè el lector de pantalla la ignori.
  4. Només si no podeu utilitzar alt, recorreu a aria-label o aria-labelledby.
  5. No confieu en el nom del fitxer ni en l'atribut title com a única alternativa.

Exemple pràctic

Aquest error és molt comú a les capçaleres: el logotip que porta a la portada i el botó de cerca fet amb una imatge. L'exemple és la capçalera d'una botiga en línia de ferreteria.

Així no: Logotip enllaçat i botó d'imatge sense text alternatiu

La imatge de l'enllaç a l'inici no té alt, aria-label ni aria-labelledby. El botó <input type="image"> tampoc. El lector de pantalla anuncia un enllaç sense nom o la ruta del fitxer. Del botó només diu «botó» o un genèric com «Envia». No se sap on porta l'enllaç ni què fa el botó. Per notar-ho, recorreu la demostració amb Tab i amb NVDA o VoiceOver activat.

Captura de pantalla de l'exemple incorrecte: Logotip enllaçat i botó d'imatge sense text alternatiu
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>
  .cabecera { display: flex; flex-wrap: wrap; align-items: center; gap: 24px; }
  .buscador { display: flex; align-items: center; gap: 8px; }
  .buscador input[type="search"] { padding: 6px 8px; border: 1px solid #595959; border-radius: 4px; }
  a:focus-visible, input:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
</style>
<header class="cabecera">
  <a href="#"><img src="data:image/svg+xml,…" width="160" height="40"></a>
  <form class="buscador" action="#" role="search">
    <label for="buscar">Cerca productes</label>
    <input type="search" id="buscar" name="q">
    <input type="image" src="data:image/svg+xml,…" width="32" height="32">
  </form>
</header>

Així sí: Text alternatiu al logotip i al botó d'imatge

La imatge de l'enllaç rep un alt amb el text del logotip i la destinació. El botó d'imatge rep alt="Cerca". Ara els dos controls tenen nom i el text substitueix la imatge sense perdre informació.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<style>
  .cabecera { display: flex; flex-wrap: wrap; align-items: center; gap: 24px; }
  .buscador { display: flex; align-items: center; gap: 8px; }
  .buscador input[type="search"] { padding: 6px 8px; border: 1px solid #595959; border-radius: 4px; }
  a:focus-visible, input:focus-visible { outline: 3px solid #412c56; outline-offset: 2px; }
</style>
<header class="cabecera">
  <a href="#"><img src="data:image/svg+xml,…" width="160" height="40" alt="Casa Soler, pàgina d'inici"></a>
  <form class="buscador" action="#" role="search">
    <label for="buscar">Cerca productes</label>
    <input type="search" id="buscar" name="q">
    <input type="image" src="data:image/svg+xml,…" width="32" height="32" alt="Cerca">
  </form>
</header>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Activeu NVDA (o VoiceOver a macOS) i recorreu la capçalera amb Tab.
  2. A NVDA, en mode d'exploració, premeu G per saltar d'imatge en imatge i escoltar el nom de cadascuna.
  3. Comproveu que l'enllaç del logotip i el botó d'imatge anuncien un nom amb sentit. No serveix «enllaç» sense res més, la ruta del fitxer ni un genèric com «Envia».

Hauria d'anunciar: «Casa Soler, pàgina d'inici, enllaç» i «Cerca, botó»

Eines del navegador

  1. Obriu les eines de desenvolupament (F12) i inspeccioneu cada img, area i input type="image".
  2. Al tauler Accessibilitat de Chrome o de Firefox, mireu el nom calculat (Name). No ha d'estar buit ni sortir només del nom del fitxer.
  3. A la consola, llisteu els elements sospitosos amb document.querySelectorAll('img:not([alt]):not([aria-label]):not([aria-labelledby]), input[type=image]:not([alt]), area:not([alt])') i reviseu-los un per un.

Validació automàtica

  1. axe DevTools detecta aquest error amb les regles image-alt (imatges), input-image-alt (botons d'imatge) i area-alt (zones de mapes d'imatge). WAVE el marca com a «Missing alternative text», «Linked image missing alternative text» o «Image button missing alternative text».
  2. Aquestes eines no detecten si el text que ja existeix té sentit. Un alt="logo" supera la prova automàtica encara que no serveixi (això és l'error F30).

Errors freqüents en auditories

  • Logotips enllaçats a la portada sense alt: deixen un enllaç sense nom a totes les pàgines del lloc.
  • Botons de cerca o d'enviament fets amb input type="image" sense alt, freqüents en plantilles antigues.
  • Imatges afegides per JavaScript (carrusels, càrrega diferida) que es creen sense alt perquè l'script no el copia.
  • Mapes d'imatge en què la imatge té alt, però les zones area no.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica F65 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 de les imatges. Si no hi ha cap font de text que proporcioni una alternativa per a la imatge, les tecnologies de suport no poden identificar la imatge ni transmetre'n el propòsit a l'usuari. L'atribut alt continua sent la manera preferible de proporcionar text alternatiu per a les imatges. Es poden utilitzar els atributs de WAI-ARIA apropiats per proporcionar text alternatiu, sempre que siguin compatibles amb l'accessibilitat. Per a més informació sobre la compatibilitat amb l'accessibilitat, consulteu Documentar la compatibilitat amb l'accessibilitat. L'especificació Accessible Name and Description Computation descriu el mètode per obtenir l'alternativa textual a partir dels atributs HTML i WAI-ARIA d'un element.

Algunes tecnologies de suport intenten compensar l'absència d'alternatives textuals llegint el nom del fitxer de la imatge. Tanmateix, basar-se únicament en el nom del fitxer és insuficient per molts motius. Per exemple, els noms de fitxer poden no ser descriptius (p. ex., images/nav01.gif), i les especificacions de les tecnologies no exigeixen noms de fitxer descriptius. A més, algunes tecnologies de suport no llegeixen el nom del fitxer si no s'ha proporcionat una alternativa textual mitjançant atributs HTML.

Exemples

Alternativa textual absent

En l'exemple de codi següent, la persona que utilitza un lector de pantalla no sabria quin és el propòsit de la imatge.

<img src="../images/animal.jpg">

Proves

Procediment

Identificar els elements img, area i input de tipus image. Per a cadascun d'aquests elements:

  1. Comprovar si hi ha l'atribut alt.
  2. Comprovar si hi ha l'atribut aria-labelledby I fa referència a un o més atributs id de la pàgina I comprovar si aria-labelledby és compatible amb l'accessibilitat.
  3. Comprovar si hi ha l'atribut aria-label I comprovar si aria-label és compatible amb l'accessibilitat.
  4. Comprovar si hi ha l'atribut title I comprovar si title és compatible amb l'accessibilitat.

Resultats esperats

  • Si totes les comprovacions núm. 1, núm. 2, núm. 3 i núm. 4 són falses, es dona aquesta condició d'error.

Recursos

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