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

Tècnica Tècniques generals WCAG 2.2

G211Fer que el nom intern d'un control coincideixi amb el seu text visible

Nom oficial al W3C: Fer coincidir el nom accessible amb l'etiqueta visible

Versión en castellano

En poques paraules

Cada botó, enllaç o camp té un nom intern que llegeixen els lectors de pantalla i els programes de control per veu. Aquesta tècnica demana que aquest nom sigui igual que el text que es veu a la pantalla. Així, qui diu «prem Cerca» activa el botó que veu escrit «Cerca».

Per què és important

Les persones que fan servir l'ordinador amb la veu diuen en veu alta el text que veuen: «prem Envia», «prem Cita prèvia». El programa busca un control amb aquest nom intern (l'anomenat nom accessible).

Si el botó mostra «Envia» però el seu nom intern és «Confirma el formulari», l'ordre no funciona. La persona no sap quina paraula ha de fer servir i es queda bloquejada.

També ajuda qui fa servir un lector de pantalla (programa que llegeix en veu alta la pantalla) i a més veu la pantalla: el que sent coincideix amb el que veu.

Com es fa

  1. Deixeu que el text visible sigui el nom: un <button> amb text o un <label> ben associat al camp ja ho aconsegueixen.
  2. Si feu servir aria-label o aria-labelledby, repetiu-hi exactament el text visible.
  3. Si necessiteu afegir informació, poseu el text visible al principi: «Cerca al web» per a un botó que mostra «Cerca».
  4. Preneu com a etiqueta el text enganxat al control. Un títol de secció o la llegenda d'un grup de camps no compten com a etiqueta.
  5. Reviseu icones amb text, enllaços «Llegeix-ne més» i botons d'imatge amb paraules a dins: el nom ha de contenir aquestes paraules.

Com comprovar-ho

  1. Localitzeu tots els controls que tenen un text visible: botons, enllaços i camps amb etiqueta.
  2. Obriu les eines del navegador (tecla F12) i mireu el nom accessible al tauler d'accessibilitat.
  3. Comproveu que el nom coincideix amb el text visible o que, almenys, comença per aquest text.
  4. Si disposeu de control per veu, digueu «prem» seguit del text visible i verifiqueu que s'activa el control correcte.

Exemple

El botó mostra «Cerca» i el seu nom accessible comença per aquesta mateixa paraula.

<!-- Incorrecte: el nom no conté el text visible -->
<button aria-label="Llança la consulta">Cerca</button>

<!-- Correcte -->
<button>Cerca</button>
<button aria-label="Cerca al catàleg">Cerca</button>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica G211 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 sense perjudicar altres usuaris de tecnologies de suport.

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 al costat d'un camp d'entrada o el text dins d'un botó o d'un enllaç). Per exemple, poden dir «clic cercar» per activar un botó etiquetat com a Cerca. Quan el programari de reconeixement de veu processa l'entrada parlada i cerca coincidències, utilitza el nom accessible dels controls. Quan el text de l'etiqueta i el text del nom accessible no coincideixen, poden sorgir problemes per a l'usuari. La manera més senzilla d'ajudar els usuaris d'entrada per veu i complir el criteri de conformitat 2.5.3 Etiqueta en el nom és garantir que el nom accessible coincideixi amb l'etiqueta de text visible.

Determinar l'etiqueta adequada

De vegades hi ha més d'una cadena de text situada a prop d'un control que es podria considerar candidata a ser-ne l'etiqueta. Per exemple, un conjunt de camps, cadascun amb la seva pròpia etiqueta, pot anar precedit a més d'un encapçalament, una instrucció o una etiqueta de grup (com ara un legend/fieldset d'HTML o un group o radiogroup d'ARIA). Tingueu en compte que el terme «etiqueta de grup» vol dir una cosa diferent d'«etiqueta», tant des del punt de vista del programari com pel que fa al criteri de conformitat 2.5.3 Etiqueta en el nom.

El document Comprendre el criteri de conformitat 2.5.3 Etiqueta en el nom recomana que, en avaluar l'etiqueta d'un control a l'efecte de complir el 2.5.3, només es tracti com a etiqueta la cadena de text adjacent o molt pròxima al camp (vegeu la secció «Identifying label text for components»). Hi ha raons tant pràctiques com tècniques per restringir d'aquesta manera la designació de l'etiqueta d'un camp. Les raons tècniques es tracten a la secció del document de Comprensió titulada Accessible Name and Description Computation specification.

Exemples

En moltes tecnologies, la correspondència entre l'etiqueta visible i el nom accessible s'aconsegueix complint el criteri de conformitat 1.3.1 Informació i relacions mitjançant l'ús correcte de la semàntica nativa. Molts controls obtenen el seu nom accessible de l'imbricació correcta dels elements, mentre que altres elements disposen d'atributs específics que constitueixen un mitjà vàlid per proporcionar o referenciar un nom accessible.

Sempre que sigui possible, el nom accessible s'ha d'assignar mitjançant elements i semàntica nadius. Això ajuda a garantir una coincidència exacta entre l'etiqueta visible i el nom.

El text de l'enllaç proporciona tant l'etiqueta de l'enllaç com el seu nom accessible

Amb HTML convencional, el text situat entre les etiquetes de l'element a proporciona tant el text visible de l'enllaç com el nom accessible "Code of conduct" (Codi de conducta):

<p>Go to our <a href="url-to-page-about-code.html">Code of conduct</a></p>

Mostra no funcional d'enllaç

Consulteu el nostre Codi de conducta

El text de l'element label proporciona el nom del camp mitjançant l'atribut for

El text situat entre les etiquetes label serveix també com a nom accessible "Notify me of delays" (Aviseu-me dels retards) de la casella de selecció, gràcies a l'atribut for, que fa referència a l'id de l'input.

<input type="checkbox" id="notification" name="notify" value="delays">
<label for="notification">Notify me of delays</label>

Mostra funcional de camp

El text del botó proporciona el nom accessible

El text dins d'un element button es converteix tant en la seva etiqueta visible com en el seu nom accessible:

<button>Send</button>

Mostra no funcional de botó

Grup senzill de botons d'opció

Els botons d'opció solen aparèixer en grup, en què cada botó està etiquetat i el grup de botons va precedit d'informació que explica o categoritza el grup.

Truqueu-me quan el saldo superi 10.000 $, Sí No
Figura 1: grup de botons d'opció "Call me when balance exceeds $10,000" (Truqueu-me quan el saldo superi 10.000 $), amb les opcions Yes (Sí) i No

L'etiqueta de cada component s'ha de limitar a "Yes" i "No". Per complir els criteris de conformitat 1.3.1 Informació i relacions i 3.3.2 Etiquetes o instruccions, el text "Call me…" es pot codificar de manera que transmeti la relació a les tecnologies de suport, en aquest exemple mitjançant un fieldset i un legend.

Si l'etiqueta no es limita a la cadena adjacent al botó d'opció, les múltiples interpretacions del que constitueix l'etiqueta poden donar lloc a un funcionament menys uniforme. Si "Yes" tot sol no és l'etiqueta del primer botó d'opció, ho és "Call me when balance exceeds $10,000"? O és una combinació de cadenes de text i, en aquest cas, l'ordre és "Call me when balance exceeds $10,000 Yes" o "Yes, Call me when balance exceeds $10,000"? Les decisions de combinar cadenes de text poden tenir efectes negatius per als usuaris de lectors de pantalla, ja que l'ordre de concatenació pot afectar el significat. En aquest exemple, "No, call me when balance exceeds $10,000" (No, truqueu-me quan el saldo superi 10.000 $) podria resultar molt confús per a un usuari de lector de pantalla.

<fieldset>
  <legend>Call me when balance exceeds $10,000?</legend><br />
  <input type="radio" id="yes" name="callme" value="yes">
  <label for="yes">Yes</label>
  <input type="radio" id="no" name="callme" value="no">
  <label for="no">No</label>
</fieldset>

Exemple funcional de grup senzill de botons d'opció

Agrupacions de caselles de selecció

En les agrupacions de caselles de selecció, les implementacions que intenten incorporar al nom accessible alguna cosa més que l'etiqueta immediata de la casella també poden resultar problemàtiques si no es limiten a la cadena de text adjacent.

Què valoreu del nostre servei? (Marqueu totes les que correspongui) Cortesia, Rapidesa, Horari de la botiga, Coneixements
Figura 2: grup de caselles de selecció "What do you value in our service?" (Què valoreu del nostre servei?), amb 4 opcions.

A la figura 2 hi ha una cadena de text llarga que combina una etiqueta de grup i una instrucció: "What do you value in our service (check all that apply)?" (Què valoreu del nostre servei? Marqueu totes les que correspongui). Cadascuna de les caselles té a més la seva pròpia etiqueta d'una o dues paraules. Pel que fa al 2.5.3, les etiquetes dels components s'han de limitar a "Courtesy", "Promptness", "Store Hours" i "Knowledge".

Intentar incloure el text precedent com a part del nom accessible pot dificultar que els usuaris d'entrada per veu aïllin un control mitjançant ordres parlades. Una construcció així també augmentarà de manera negativa la verbositat per als usuaris de lectors de pantalla (en llegir-se les cadenes de text combinades per a cadascun dels camps abans del seu estat). La solució més senzilla és limitar el nom accessible al text situat immediatament al costat de les caselles, utilitzant tècniques similars a les del grup estàndard de botons d'opció.

Etiquetes apilades

Encara que les etiquetes dels quadres combinats, les llistes desplegables, els camps de text i altres components se situen normalment just a l'esquerra del component, hi ha una altra convenció establerta en què les etiquetes s'apilen a sobre dels camps, alineades amb la seva vora esquerra.

dos camps etiquetats com a Email (correu electrònic) i Password (contrasenya)
Figura 3: dos camps amb les etiquetes situades a sobre i a l'esquerra.

A la figura 3, els camps estan apilats i alineats a l'esquerra, amb les etiquetes immediatament abans de cada camp, també alineades a l'esquerra. Hi ha un espai en blanc addicional entre l'etiqueta i el camp anterior, de manera que l'etiqueta queda més a prop del camp de text al qual està associada. Les etiquetes apilades són relativament habituals en els dissenys per a mòbil, en què l'espai horitzontal és limitat.

La figura 4 mostra una variant de les etiquetes apilades en què s'inclouen pistes i indicacions entre l'etiqueta i el camp. Aquest disseny no proporciona una etiqueta adjacent. No obstant això, l'etiqueta "New Password" (Contrasenya nova) es continua considerant prou pròxima, sobretot per la seva mida i la seva negreta en comparació amb el text d'ajuda, més petit i de menys contrast. Les associacions es reforcen per programari: al text d'ajuda se li assigna una funció d'aria-describedby i l'etiqueta està correctament associada al camp.

Contrasenya nova. Les contrasenyes han de tenir 10 caràcters o més i contenir almenys una majúscula, un número i un caràcter no alfanumèric.
Figura 4: etiqueta "New password" (Contrasenya nova) situada a sobre del camp, amb una cadena de text de mida més petita sobre els requisits de la contrasenya entre l'etiqueta gran i el camp.

En aquest tipus d'implementacions, el text d'ajuda s'hauria de limitar a una sola línia sempre que sigui possible, ja que poden sorgir problemes d'accessibilitat quan una ajuda més extensa separa l'etiqueta del seu camp. La figura 4 il·lustra que el concepte de «text adjacent» és una guia per interpretar l'etiqueta, però no sempre pot servir com a regla estricta.

<form>
  <label class="label" for="example-2">New password</label>
  <span id="example-2-hint" class="hint">
    Passwords must be 10 or more characters, and contain at least one capital, numeric and non-alphanumeric.
  </span>
  <input class="input" id="example-2" name="example-2" type="password"
         autocomplete="new-password" aria-describedby="example-2-hint">
</form>

Exemple funcional d'etiquetes apilades

Rang de camps amb poques etiquetes

Una discrepància menys habitual entre etiquetes i camps es pot donar quan un grup de botons d'opció es configura per recollir una elecció dins d'un rang. Les etiquetes es poden situar únicament a cada extrem del rang o intercalar-se en diferents punts del rang.

Valoreu la vostra resposta, Hated it (No m'ha agradat gens), Loved it (M'ha encantat)
Figura 5: fila de 5 botons d'opció amb les etiquetes Hated it (No m'ha agradat gens) i Loved it (M'ha encantat) a cada extrem

Les dues etiquetes, "Hated it" i "Loved it", són adjacents al primer i a l'últim botó d'opció, i n'haurien de ser els noms accessibles. Els usuaris d'entrada per veu poden pronunciar qualsevol d'aquestes etiquetes per seleccionar un botó d'opció i després fer servir la navegació amb fletxes (per exemple, «prem fletxa dreta») per modificar la selecció. "Rate your response" (Valoreu la vostra resposta) és el text que descriu el component complet i es pot associar com a etiqueta de grup (aquí mitjançant legend). Els tres botons d'opció centrals no tenen etiquetes visibles. En l'exemple de codi se'ls assignen atributs title amb els valors "Disliked", "So-so" i "Liked" (No m'ha agradat, Regular i M'ha agradat) per complir el criteri de conformitat 3.3.2 Etiquetes o instruccions.

<fieldset>
  <legend>Rate your response</legend>
  <label for="hated">Hated it</label>
  <input type="radio" name="meal" id="hated" value="hated">
  <input type="radio" name="meal" id="poor" value="poor" title="Disliked">
  <input type="radio" name="meal" id="neutral" value="neutral" title="So-so">
  <input type="radio" name="meal" id="okay" value="okay" title="Liked">
  <input type="radio" name="meal" id="loved" value="loved">
  <label for="loved">Loved it</label>
</fieldset>

Exemple funcional de rang de camps

Text entre parèntesis i signes de puntuació

La tècnica G211 no pretén complicar les convencions existents per a la construcció de camps de formulari accessibles. Tal com es descriu a les subseccions Punctuation and capitalization i Text in parentheses del document de Comprensió, no sempre cal incloure tota la informació en el nom accessible per intentar complir el requisit d'Etiqueta en el nom, especialment quan es tracta de text que normalment no es pronunciaria en fer servir el reconeixement de veu per arribar als controls. Quan hi ha maneres establertes de garantir que la informació i les relacions transmeses visualment estiguin presents per programari, és acceptable deixar fora del nom accessible el text entre parèntesis i els signes de puntuació.

El fragment següent mostra possibles tècniques esmentades al document de Comprensió. Atès que el caràcter obligatori del camp s'indica per programari i que les restriccions d'entrada de la data s'exposen mitjançant aria-describedby, l'asterisc i la informació entre parèntesis s'han deixat fora del nom accessible.

Dos camps de text: un amb l'etiqueta 'Name' (Nom) amb un asterisc i un altre amb l'etiqueta 'Birth date' (Data de naixement) i, entre parèntesis, YYYY-MM-DD
Figura 6: les etiquetes "Name" (Nom) i "Birth date" (Data de naixement) amb informació addicional (un asterisc i una instrucció de format d'entrada, respectivament)
<label for="name">Name</label> *
<input type="text" name="name" id="name" autocomplete="name" required>
<label for="birth">Birth date</label> (<span id="mask">YYYY-MM-DD</span>)
<input type="text" name="birth" id="birth" autocomplete="bday" aria-describedby="mask">

Exemple funcional de camps amb noms accessibles simplificats

Proves

Procediment

  1. En els controls d'entrada, examinar cada camp que tingui un text adjacent que serveixi com a etiqueta seva
  2. Per a cada camp, comprovar que la cadena de text completa de l'etiqueta (sense tenir en compte, opcionalment, majúscules i minúscules, signes de puntuació i informació entre parèntesis) coincideix amb el nom accessible del camp, segons el càlcul del nom accessible
  3. En els botons, enllaços, menús i altres controls que no siguin camps d'entrada, examinar cada control que contingui un text que serveixi com a etiqueta seva
  4. Per a cada control que no sigui un camp d'entrada, comprovar que la cadena de text completa de l'etiqueta (sense tenir en compte, opcionalment, majúscules i minúscules, signes de puntuació i informació entre parèntesis) coincideix amb el nom accessible del control

Resultats esperats

  • Les comprovacions núm. 2 i núm. 4 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 G211 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.