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

Tècnica HTML WCAG 2.2

H37Utilitzar l'atribut alt en les imatges

Nom oficial al W3C: Utilitzar atributs alt en els elements img

Versión en castellano

En poques paraules

Cada imatge que aporta informació necessita un atribut alt amb un text curt que compleixi la mateixa funció que la imatge. Si la imatge conté paraules importants, l'alt les ha d'incloure. Si és un enllaç, ha de dir on porta. Les imatges merament decoratives porten l'alt buit.

Per què és important

Les persones cegues utilitzen lectors de pantalla (programes que llegeixen en veu alta el que hi ha a la pantalla). Aquests programes no veuen la imatge: en llegeixen l'alt.

  • Sense alt, el lector pot llegir el nom del fitxer, com ara «banner-def-02.jpg».
  • Amb un alt pobre, com ara «imatge», la persona es perd la informació.
  • L'alt també es mostra si la imatge no es carrega per una mala connexió.

Com es fa

  1. Pregunteu-vos què aporta la imatge en aquella pàgina. Escriviu això a l'alt, no el seu aspecte.
  2. Si la imatge té text, com ara un bàner o un cartell, copieu aquestes paraules a l'alt.
  3. Si la imatge és un enllaç o un botó, indiqueu-ne la destinació o l'acció: «Ves a la pàgina d'inici».
  4. No comenceu amb «Imatge de» o «Foto de». El lector ja avisa que és una imatge.
  5. Si la imatge és merament decorativa, poseu alt="" perquè el lector la ignori.
  6. Sigueu breus. Si la imatge necessita una explicació llarga, com ara un gràfic, poseu-la en el text de la pàgina.

Exemple pràctic

El cas més habitual és un bàner enllaçat que porta text dins de la imatge. El seu alt ha de recollir aquestes paraules. Exemple: un bàner a la portada d'un ajuntament que porta a la cita prèvia.

Així no: Bàner enllaçat amb un alt que no recull el text de la imatge

La imatge enllaçada té text, però l'alt la descriu en lloc de copiar-ne les paraules. El lector de pantalla anuncia «Imatge promocional de l'Ajuntament, enllaç». No se sap que l'enllaç serveix per demanar cita prèvia. Per adonar-vos-en, recorreu la demo amb Tab i amb NVDA o VoiceOver activat.

Captura de pantalla de l'exemple incorrecte: Bàner enllaçat amb un alt que no recull el text de la imatge
Així es veu l'exemple incorrecte.

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

Mostra el codi de l'exemple incorrecte
<style>
  .promo h2 { font-size: 1.2rem; margin: 0 0 8px; color: #0B2239; }
  .promo a { display: inline-block; border-radius: 8px; }
  .promo a:focus-visible { outline: 3px solid #0B2239; outline-offset: 3px; }
  .promo img { display: block; max-width: 100%; height: auto; }
</style>
<aside class="promo">
  <h2>Serveis en línia</h2>
  <a href="#">
    <img src="data:image/svg+xml,…" width="320" height="90" alt="Imatge promocional de l'Ajuntament">
  </a>
</aside>

Així sí: Bàner enllaçat amb les paraules de la imatge a l'alt

L'alt copia el text del bàner, que a més diu on porta l'enllaç. Així compleix la mateixa funció que la imatge. L'enllaç té un nom que s'entén encara que es llegeixi sol.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  .promo h2 { font-size: 1.2rem; margin: 0 0 8px; color: #0B2239; }
  .promo a { display: inline-block; border-radius: 8px; }
  .promo a:focus-visible { outline: 3px solid #0B2239; outline-offset: 3px; }
  .promo img { display: block; max-width: 100%; height: auto; }
</style>
<aside class="promo">
  <h2>Serveis en línia</h2>
  <a href="#">
    <img src="data:image/svg+xml,…" width="320" height="90" alt="Cita prèvia per internet: demaneu cita sense cues, les 24 hores">
  </a>
</aside>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Recorreu els enllaços amb Tab. Amb NVDA també podeu utilitzar la tecla K en mode exploració.
  2. Compareu el que s'anuncia amb el text que es veu a la imatge. Les paraules importants hi han de coincidir.

Hauria d'anunciar: «Cita prèvia per internet: demaneu cita sense cues, les 24 hores, enllaç»

Eines del navegador

  1. Obriu les eines del navegador (F12) i inspeccioneu cada imatge. Llegiu-ne l'atribut alt o el nom (Name) al tauler Accessibilitat.
  2. En les imatges amb text, comproveu que l'alt inclou aquest text. En les altres, comproveu que en transmet la funció o la informació, no l'aspecte.

Validació automàtica

  1. La regla image-alt d'axe DevTools (i de Lighthouse) i WAVE només comproven que l'alt existeixi. No verifiquen que inclogui les paraules de la imatge.
  2. WAVE mostra l'alt de cada imatge al costat. Això agilita la revisió manual.

Errors freqüents en auditories

  • Bàners i carrusels amb text a dins que tenen com a alt «banner», «slider» o una descripció visual, sense les paraules de la imatge.
  • Començar l'alt amb «Imatge de…» o «Foto de…». El lector ja avisa que és una imatge.
  • Utilitzar imatges de text que haurien de ser text real (criteri 1.4.5). L'alt ajuda el lector de pantalla, però no qui amplia la pàgina o en canvia els colors.
  • En imatges enllaçades, descriure la imatge en lloc de la destinació o l'acció de l'enllaç.
Veure el text complet del W3C (traducció al català)

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

Imatges utilitzades en documents HTML.

Descripció

Quan utilitzeu l'element img, especifiqueu una alternativa textual curta amb l'atribut alt. Nota: el valor d'aquest atribut se sol anomenar «text alternatiu» o «text alt».

Quan una imatge conté paraules importants per entendre el contingut, el text alternatiu ha d'incloure aquestes paraules. Això permet que el text alternatiu compleixi a la pàgina la mateixa funció que la imatge. Tingueu en compte que no descriu necessàriament les característiques visuals de la imatge mateixa, però ha de transmetre el mateix significat que la imatge.

Exemples

Una imatge d'un lloc web proporciona un enllaç a un butlletí gratuït. La imatge conté el text "Free newsletter. Get free recipes, news, and more. Learn more." (butlletí gratuït; rebeu receptes, notícies i molt més de franc; més informació). El text alternatiu coincideix amb el text de la imatge.

<img src="newsletter.gif" alt="Free newsletter. 
 Get free recipes, news, and more. Learn more.">

Una imatge d'un lloc web representa el plànol d'un edifici. La imatge és un mapa d'imatge en què cada habitació és una àrea interactiva del mapa. El text alternatiu és «Plànol de l'edifici. Seleccioneu una habitació per obtenir més informació sobre la seva finalitat o el seu contingut». La instrucció de «seleccionar una habitació» indica que la imatge és interactiva.

Proves

Procediment

  1. Examinar cada element img del contingut.
  2. Comprovar que cada element img que transmet significat conté un atribut alt.
  3. Si la imatge conté paraules importants per entendre el contingut, comprovar que aquestes paraules estan incloses en l'alternativa textual.

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