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

Tècnica Tècniques generals WCAG 2.2

G208Incloure el text visible d'un control en el seu nom accessible

Nom oficial al W3C: Incloure el text de l'etiqueta visible com a part del nom accessible

Versión en castellano

En poques paraules

Cada enllaç, botó o camp té un nom intern que fan servir els lectors de pantalla i els programes de control per veu. Aquest nom ha de contenir el text que es veu a la pantalla, amb les mateixes paraules i en el mateix ordre. El millor és que comenci per aquest text. Així, qui diu «prem Envia» activa el botó correcte.

Per què és important

Les persones que fan servir l'ordinador amb la veu diuen en veu alta el que veuen: «prem Cerca». El seu programa busca un control el nom del qual contingui aquesta paraula.

Si el botó mostra «Ves» però el seu nom intern és «Cerca», l'ordre no funciona. Passa molt amb aria-label, que substitueix el text visible. És un requisit de nivell A (criteri 2.5.3).

Com es fa

  1. Sempre que pugueu, deixeu que el text visible sigui el nom mateix del control, sense aria-label.
  2. Si necessiteu afegir context, poseu-lo després del text visible: «Llegeix-ne més» pot ser «Llegeix-ne més sobre els ajuts al lloguer».
  3. Quan feu servir aria-label o aria-labelledby, copieu el text visible complet, lletra per lletra.
  4. Per a informació addicional que no forma part del nom, feu servir aria-describedby. No altera el nom del control.
  5. En camps de formulari, el nom ha d'incloure el text de la seva etiqueta visible.

Com comprovar-ho

  1. Obriu les eines del navegador (F12), seleccioneu el control i mireu-ne el «Name» al tauler «Accessibilitat».
  2. Compareu aquest nom amb el text visible: l'ha de contenir sencer i en el mateix ordre.
  3. Si és possible, proveu-ho amb un programa de control per veu: Voice Access a Android, Control per veu a Mac o iPhone, o Dragon a Windows. Digueu «prem» seguit del text visible i comproveu que s'activa el control.

Exemple

Un botó el nom del qual no coincideix amb el que es veu, i un enllaç que amplia el text visible sense trencar-lo.

<!-- Malament: es veu «Ves», però el nom és «Cerca» -->
<button aria-label="Cerca">Ves</button>

<!-- Bé: el nom comença pel text visible -->
<a href="normas.html">
  Normes d'ús<span class="solo-lector"> del poliesportiu</span>
</a>
Veure el text complet del W3C (traducció al català)

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

Aquesta tècnica s'aplica a totes les tecnologies web que inclouen controls interactius (com ara enllaços o camps de formulari)

Descripció

L'objectiu d'aquesta tècnica és garantir que els usuaris d'entrada per veu puguin manejar el contingut web de manera fiable.

Quan els usuaris d'entrada per veu interactuen amb una pàgina web, normalment pronuncien una ordre seguida de la referència a alguna etiqueta visible (com ara el text d'un botó, el text d'un enllaç o el text que etiqueta un camp d'entrada). Per exemple, poden dir «clic cercar» per activar un botó de cerca.

Quan el programari de reconeixement de veu processa l'entrada parlada i cerca coincidències, utilitza el «nom accessible» dels controls, que pot ser diferent de l'etiqueta visible. Per exemple, un botó situat després d'un camp de cerca pot contenir el text "go" (ves), però fer servir un atribut aria-label invisible amb el valor "search" (cerca). Atès que aria-label té prioritat sobre el text inclòs al botó, el nom accessible d'aquest botó serà "search", no "go". L'especificació Accessible Name and Description Computation defineix com es construeix el nom accessible.

En les situacions en què l'etiqueta visible es consideri insuficient com a nom accessible, és possible complementar el text del nom accessible. No obstant això, per complir el criteri de conformitat 2.5.3 Etiqueta en el nom, la cadena de text que forma l'etiqueta visible ha d'aparèixer en la seva totalitat dins del nom accessible. En la majoria de les situacions en què es consideri necessari afegir context, es recomana que el text visible precedeixi el text addicional. Quan qui desenvolupa s'assegura que l'etiqueta visible d'un control està inclosa, intacta, en el nom accessible d'aquest control, els usuaris d'entrada per veu poden confiar que la seva entrada s'interpretarà correctament.

Pot resultar més apropiat incloure el context addicional mitjançant la descripció accessible (per exemple, fent servir aria-describedby). Això té el gran avantatge de millorar el context per a alguns usuaris de tecnologies de suport sense alterar el nom accessible.

Exemples

El text de l'enllaç coincideix amb el començament del nom accessible

Un enllaç conté text visible i text ocult. Tots dos junts formen el nom accessible de l'enllaç. El text visible va primer. La idea és que l'enllaç resulti més descriptiu per als usuaris de tecnologies de suport.

<p>Go to <a href="code-of-conduct.html">Code of conduct <span class="hidden_accessibly"> of ACME Corporation</span></a><p>

Text d'enllaç genèric concatenat amb l'encapçalament

Un enllaç genèric es combina amb l'encapçalament del paràgraf per donar-li context. És una variant del primer exemple, aquesta vegada fent servir aria-labelledby. L'avantatge d'aquesta implementació és que utilitza text visible que ja existeix a la pàgina, per la qual cosa és més probable que es tradueixi correctament en qualsevol procés de localització.

<h4 id="poor">Insufficient Link Names Invade Community</h4>
<p>Citizens are reeling from the growing invasion of useless "read more" links appearing in their online resources. <a href="poor.html" aria-labelledby="generic poor"><span id="generic">More...</span></a>

Insufficient Link Names Invade Community

[L'enllaç següent no obre res] Citizens are reeling from the growing invasion of useless "read more" links appearing in their online resources. More...

Text de l'enllaç inclòs a aria-label

Quan dues cadenes no es poden combinar de manera gramatical o fluida mitjançant aria-labelledby, es pot fer servir aria-label per crear un nom nou que inclogui l'etiqueta visible.

...end of news story. <a href="poor.html" aria-label="Read more about Insufficient link names">Read more</a>

El text visible del botó coincideix amb el començament del nom accessible

El text visible dins d'un element button coincideix amb el començament del nom accessible, que a més inclou text ocult. La idea del text ocult és que el botó resulti més descriptiu per als usuaris de tecnologies de suport.

<button>Send <span class="accessibly-hidden"> Mail</span></button>

Recursos

Proves

Procediment

Per a tots els controls amb una etiqueta visible, comprovar que:

  1. El nom accessible del control conté les mateixes lletres, en el mateix ordre, que l'etiqueta visible.

Resultats esperats

  • La comprovació núm. 1 és certa.

Si aquesta és una tècnica suficient per a un criteri de conformitat, no superar aquest procediment de prova no vol dir necessàriament que el criteri de conformitat no s'hagi satisfet d'una altra manera, sinó només que aquesta tècnica no s'ha implementat correctament i no es pot utilitzar per declarar la conformitat.

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