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

Tècnica HTML WCAG 2.2

H30Escriure textos d'enllaç que diguin on porten

Nom oficial al W3C: Proporcionar en els elements d'ancoratge un text d'enllaç que descrigui el propòsit de l'enllaç

Versión en castellano · Irakurri fitxa hau euskaraz

En poques paraules

El text de cada enllaç, és a dir, el que hi ha dins de l'element a, ha de dir on porta o què fa. Si l'enllaç conté una imatge, el seu text alternatiu compta com a part del text de l'enllaç. Una ruta de fitxer o un nom d'imatge no diuen res a qui escolta l'enllaç.

Per què és important

Les persones que utilitzen lector de pantalla solen saltar d'enllaç en enllaç o demanar la llista de tots els enllaços. Només en senten el text.

Si el text és «/docs/of-2027.pdf» o «icono-pdf.svg», no saben quin document obriran. El mateix passa amb un enllaç que només té una imatge sense alt. Un text clar també ajuda qui llegeix de pressa o té dificultats de comprensió.

Com es fa

  1. Escriviu com a text de l'enllaç el nom de la destinació: «Ordenances fiscals 2027», no l'adreça ni el nom del fitxer.
  2. Si l'enllaç és només una imatge, poseu al seu alt la destinació o l'acció, no el que es veu: «Inici», no «casa».
  3. Si l'enllaç té text i imatge, utilitzeu alt="" quan el text ja és suficient. Si la imatge hi afegeix alguna cosa, com ara el format, poseu-ho a l'alt: «(PDF)».
  4. Eviteu enllaços genèrics com ara «Més informació». Si els utilitzeu, la frase o l'element de llista on són ha d'aclarir la destinació.

Exemple pràctic

És un cas molt habitual en seus electròniques i webs municipals. En els llistats de documents, el text de l'enllaç és la ruta del fitxer. I la icona de PDF porta com a alternativa el nom de la imatge.

Així no: Enllaç amb la ruta del fitxer com a text

El text de l'enllaç és la ruta del fitxer («/docs/of-2027.pdf»). La icona té alt="icono-pdf.svg". El lector de pantalla anuncia una cosa com ara «enllaç, barra docs barra of guió 2027 punt pdf, icono guió pdf punt svg». No diu quin document s'obrirà.

Captura de pantalla de l'exemple incorrecte: Enllaç amb la ruta del fitxer com a text
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>
  .docs { list-style: none; padding: 0; }
  .docs li { margin: 8px 0; }
  .docs a { color: #412c56; }
  .docs img { vertical-align: middle; margin-left: 6px; }
</style>
<h2>Normativa municipal</h2>
<ul class="docs">
  <li><a href="#">/docs/of-2027.pdf
    <img src="data:image/svg+xml,…" alt="icono-pdf.svg" width="20" height="20"></a></li>
  <li><a href="#">/docs/tasas-agua-2027.pdf
    <img src="data:image/svg+xml,…" alt="icono-pdf.svg" width="20" height="20"></a></li>
</ul>

Així sí: Text d'enllaç clar i alt útil

Ara el text de l'enllaç és el nom del document. La icona té alt="(PDF)", que hi afegeix el format. L'enllaç s'anuncia com a «Ordenances fiscals 2027 (PDF)».

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  .docs { list-style: none; padding: 0; }
  .docs li { margin: 8px 0; }
  .docs a { color: #412c56; }
  .docs img { vertical-align: middle; margin-left: 6px; }
</style>
<h2>Normativa municipal</h2>
<ul class="docs">
  <li><a href="#">Ordenances fiscals 2027
    <img src="data:image/svg+xml,…" alt="(PDF)" width="20" height="20"></a></li>
  <li><a href="#">Taxes del servei d'aigua 2027
    <img src="data:image/svg+xml,…" alt="(PDF)" width="20" height="20"></a></li>
</ul>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Recórrer els enllaços amb Tab o obrir la llista d'enllaços (NVDA: Insert + F7; VoiceOver: rotor amb VO + U).
  2. Comprovar que cada enllaç anuncia el nom del document o de la pàgina. No ha d'anunciar una adreça, un nom de fitxer ni un text genèric.
  3. En els enllaços amb imatges, comprovar que l'alt aporta alguna cosa útil, o que és buit si el text ja és suficient.

Hauria d'anunciar: «enllaç, Ordenances fiscals 2027 (PDF)»

Eines del navegador

  1. Obrir les eines de desenvolupament (F12), seleccionar cada enllaç i mirar el camp Nom del tauler Accessibilitat.
  2. Comprovar que el nom surt del contingut (text més alt de les imatges) i que s'entén llegit de cop.

Validació automàtica

  1. axe DevTools (link-name) i WAVE («Empty link») detecten els enllaços sense nom. axe (image-alt) detecta les imatges sense atribut alt.
  2. No detecten textos d'enllaç que són adreces o noms de fitxer, ni alt com ara «icono-pdf.svg». WAVE pot avisar d'alguns textos sospitosos. La qualitat del text es revisa a mà.

Errors freqüents en auditories

  • Utilitzar l'adreça o el nom del fitxer com a text de l'enllaç en llistats de baixades.
  • Deixar a l'alt de les icones el nom del fitxer d'imatge, o textos com ara «icona» o «imatge».
  • Repetir a l'alt de la imatge el text de l'enllaç, de manera que el lector l'anuncia dues vegades. Si el text és suficient, l'alt va buit.
  • Indicar el format o la mida del fitxer només amb la icona, sense text alternatiu que ho digui.
Veure el text complet del W3C (traducció al català)

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

Documents HTML que contenen enllaços (elements <a href>)

Descripció

L'objectiu d'aquesta tècnica és descriure el propòsit d'un enllaç proporcionant un text descriptiu com a contingut de l'element a. La descripció permet a l'usuari distingir aquest enllaç dels altres enllaços de la pàgina web i l'ajuda a decidir si el segueix o no. L'URI de la destinació en general no és prou descriptiu.

Quan una imatge és l'únic contingut d'un enllaç, l'alternativa textual de la imatge descriu la funció concreta de l'enllaç.

Quan el contingut d'un enllaç inclou text i una o més imatges, si el text és suficient per descriure el propòsit de l'enllaç, les imatges poden tenir una alternativa textual buida. (Consulteu Utilitzar un alt nul i cap atribut title en els elements img de les imatges que la tecnologia de suport ha d'ignorar.) Quan les imatges transmeten informació més enllà del propòsit de l'enllaç, també han de tenir un text alt adequat.

Exemples

Descriure el propòsit d'un enllaç en HTML en el contingut textual de l'element a.

<a href="routes.html">
  Current routes at Boulders Climbing Gym
</a>

Utilitzar l'atribut alt de l'element img per descriure el propòsit d'un enllaç gràfic.

<a href="routes.html">
  <img src="topo.gif" alt="Current routes at Boulders Climbing Gym">
</a> 

Utilitzar un atribut alt buit quan l'element d'ancoratge (a) conté, a més de l'element img, un text que descriu el propòsit de l'enllaç. Tingueu en compte que el text de l'enllaç apareixerà a la pàgina al costat de la imatge.

<a href="routes.html">
  <img src="topo.gif" alt="">
  Current routes at Boulders Climbing Gym
</a>

Un lloc permet als usuaris enviar opinions sobre els productes fent clic a l'enllaç "Feedback" (opinió) de la pàgina de detall de cada producte. Altres usuaris poden respondre a qualsevol opinió. Quan hi ha una resposta disponible a l'opinió de l'usuari, l'enllaç d'opinió mostra una icona, l'alternativa textual de la qual és "response received" (resposta rebuda), després del text "Feedback". El document d'ajuda del lloc descriu aquesta icona com una bafarada que conté cometes i inclou la icona, amb la seva alternativa textual, com a exemple. A les pàgines de detall de producte s'utilitza la mateixa alternativa textual (quan hi ha una resposta disponible) per contribuir que els usuaris que segueixen la documentació puguin identificar correctament la imatge tal com està documentada.

<a href="prod_123_feedback.html">
  Feedback
  <img src="response.gif" width="15" height="15" alt="response received">
</a>

Un enllaç conté text i una icona, i la icona proporciona informació addicional sobre la destinació.

<a href="WMFP.pdf">
  Woodend Music Festival Program
  <img src="pdficon.gif" alt="PDF format">
</a>

L'informe anual de l'empresa "MyCorp" es publica al lloc web corporatiu com a PDF, i el pressupost anual de l'empresa es publica al lloc web com a fitxer d'Excel.

Molts usuaris prefereixen conèixer el tipus de fitxer quan obrir un fitxer implica obrir una aplicació nova per veure'l, per la qual cosa sovint es considera útil incloure aquesta informació addicional. Tanmateix, no és obligatori per complir aquest criteri de conformitat.

<ul>
  <li>
    <a href="2009mycorp_report.pdf">MyCorp 2009 Annual Report (PDF)</a>
  </li>
  <li>
    <a href="2009mycorp_budget.xls">MyCorp 2009 Annual Budget (Excel)</a>
  </li>
</ul>

Proves

Procediment

Per a cada enllaç del contingut que utilitzi aquesta tècnica:

  1. Comprovar que l'element a inclou text o una alternativa textual per al contingut no textual.
  2. Si un element img és l'únic contingut de l'element a, comprovar que la seva alternativa textual descriu el propòsit de l'enllaç.
  3. Si l'element a conté un o més elements img i l'alternativa textual d'aquests elements img és buida, comprovar que el text de l'enllaç descriu el propòsit de l'enllaç.
  4. Si l'element a només conté text, comprovar que el text descriu el propòsit de l'enllaç.

Resultats esperats

  • Les comprovacions anteriors 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 H30 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.