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

Tècnica HTML WCAG 2.2

H44Associar cada camp de formulari amb la seva etiqueta label

Nom oficial al W3C: Utilitzar elements label per associar etiquetes de text amb controls de formulari

Versión en castellano

En poques paraules

Cada camp d'un formulari necessita una etiqueta que digui què cal escriure o triar. Aquesta etiqueta es marca amb l'element label. El seu atribut for ha de coincidir amb l'id del camp. Així el lector de pantalla l'anuncia i, en prémer el text, s'activa el camp.

Per què és important

  • Les persones cegues utilitzen lectors de pantalla (programes que llegeixen en veu alta el que hi ha a la pantalla). Sense la unió, quan arriben a un camp només senten «edició» i no saben què han d'escriure.
  • Les persones amb poca precisió a les mans poden prémer el text de l'etiqueta per activar el camp. És una zona de clic molt més gran, molt útil en caselles petites.
  • L'etiqueta visible ajuda tothom a emplenar el formulari sense errors.

Com es fa

  1. Doneu a cada camp un id únic a la pàgina: id="correo".
  2. Escriviu-ne l'etiqueta en un <label> amb for igual a aquest id: for="correo".
  3. Poseu l'etiqueta abans del camp en quadres de text i llistes. En caselles i botons d'opció, poseu-la després.
  4. Feu visible l'etiqueta. El text d'exemple dins del camp (placeholder) no la substitueix: desapareix quan s'escriu.
  5. Reviseu els id quan copieu blocs de formulari. Un id repetit o mal escrit trenca la unió.

Exemple pràctic

Serveix per a qualsevol formulari: butlletí, contacte, registre o cita prèvia. És un dels errors més repetits en les auditories. El text de l'etiqueta es veu al costat del camp, però no hi està unit en el codi.

Així no: Etiquetes visibles però no associades

El primer label no té for. El segon apunta a un id que no existeix (cp en lloc de codpostal). El text de la casella és en un span. Els camps es queden sense nom: el lector de pantalla només diu «edició» o «casella de selecció, no marcada». I en prémer el text no s'activa el camp.

Captura de pantalla de l'exemple incorrecte: Etiquetes visibles però no associades
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
<form action="#">
  <p>
    <label>Correu electrònic</label><br>
    <input type="email" name="correo" autocomplete="email">
  </p>
  <p>
    <label for="cp">Codi postal</label><br>
    <input type="text" name="cp" id="codpostal" inputmode="numeric" autocomplete="postal-code">
  </p>
  <p>
    <input type="checkbox" name="privacidad">
    <span>He llegit i accepto la política de privacitat</span>
  </p>
  <button type="submit">Subscriu-me al butlletí</button>
</form>

Així sí: label amb for igual a l'id del control

Cada camp té un id únic i el seu label l'indica a for. A la casella, l'etiqueta va després del control. Ara cada camp té nom. En prémer el text, el camp rep el focus o la casella es marca, de manera que la zona de clic és més gran.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<form action="#">
  <p>
    <label for="correo">Correu electrònic</label><br>
    <input type="email" name="correo" id="correo" autocomplete="email">
  </p>
  <p>
    <label for="cp">Codi postal</label><br>
    <input type="text" name="cp" id="cp" inputmode="numeric" autocomplete="postal-code">
  </p>
  <p>
    <input type="checkbox" name="privacidad" id="privacidad">
    <label for="privacidad">He llegit i accepto la política de privacitat</label>
  </p>
  <button type="submit">Subscriu-me al butlletí</button>
</form>

Com comprovar-ho

Ratolí i teclat

  1. Feu clic al text de cada etiqueta. El camp ha de rebre el focus. Les caselles i els botons d'opció han de canviar d'estat.
  2. Recorreu el formulari amb el tabulador. Comproveu que l'etiqueta visible és al costat del camp que rep el focus.

Lector de pantalla (NVDA o VoiceOver)

  1. Recorreu els camps amb el tabulador.
  2. Comproveu que cada camp s'anuncia amb el text de la seva etiqueta visible.

Hauria d'anunciar: «Correu electrònic, edició» i «He llegit i accepto la política de privacitat, casella de selecció, no marcada»

Eines del navegador

  1. Obriu les eines del navegador (F12) i inspeccioneu cada camp a la pestanya Accessibilitat.
  2. Comproveu que «Name» té valor i que prové de «label (for=)» o similar, no de title ni de placeholder.
  3. Verifiqueu que el valor de for coincideix exactament amb un id únic de la pàgina, també en majúscules i minúscules.

Validació automàtica

  1. La regla label d'axe DevTools i l'error «Missing form label» de WAVE detecten camps sense nom. Lighthouse inclou la mateixa comprovació d'axe.
  2. No detecten una etiqueta unida al camp equivocat ni un text que descrigui malament el camp. Això es revisa manualment.

Errors freqüents en auditories

  • Un for que no coincideix amb l'id, després de copiar i enganxar un bloc del formulari o en generar id automàtics.
  • Utilitzar només el placeholder com a etiqueta. Desapareix quan s'escriu.
  • id repetits a la pàgina, per exemple el mateix formulari de butlletí a la capçalera i al peu. L'etiqueta queda unida només al primer camp.
  • Text de caselles d'acceptació en un span o un p solt, sense label.
Veure el text complet del W3C (traducció al català)

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

Controls HTML que utilitzen etiquetes externes

Descripció

L'objectiu d'aquesta tècnica és utilitzar l'element label per associar explícitament un control de formulari amb una etiqueta. Un label es vincula a un control de formulari concret mitjançant l'atribut for. El valor de l'atribut for ha de ser el mateix que el valor de l'atribut id del control de formulari.

L'atribut id pot tenir el mateix valor que l'atribut name, però cal indicar-los tots dos, i l'id ha de ser únic a la pàgina web.

Aquesta tècnica és suficient per als criteris de conformitat 1.1.1 (Contingut no textual), 1.3.1 (Informació i relacions) i 4.1.2 (Nom, funció i valor) tant si l'element label és visible com si no ho és. És a dir, es pot amagar mitjançant CSS. No obstant això, per al criteri de conformitat 3.3.2 (Etiquetes o instruccions), l'element label ha de ser visible, ja que ofereix ajuda a tots els usuaris que necessiten entendre la finalitat del camp.

Un avantatge addicional d'aquesta tècnica és que l'àrea en què es pot fer clic per al control és més gran, ja que fer clic tant a l'etiqueta com al control activa el control. Això pot ser útil per als usuaris amb dificultats de control motor.

Tingueu en compte que el label es col·loca després dels elements input de type="checkbox" i type="radio".

Els elements que utilitzen etiquetes associades explícitament són:

  • camps d'entrada de text:
    • input type="date"
    • input type="datetime-local"
    • input type="email"
    • input type="month"
    • input type="number"
    • input type="password"
    • input type="search"
    • input type="tel"
    • input type="text"
    • input type="time"
    • input type="url"
    • input type="week"
  • input type="checkbox"
  • input type="color"
  • input type="file"
  • input type="radio"
  • input type="range"
  • select
  • textarea

L'element label no s'utilitza amb els elements següents:

  • button (l'etiqueta la proporciona el contingut)
  • input type="button" (l'etiqueta la proporciona el contingut)
  • input type="hidden"
  • input type="image" (l'etiqueta la proporciona l'atribut alt)
  • input type="reset" (l'etiqueta la proporciona l'atribut value)
  • input type="submit" (l'etiqueta la proporciona l'atribut value)

Exemples

Un camp d'entrada de text

El camp de text d'aquest exemple té l'etiqueta explícita "First name:" (Nom:). L'atribut for de l'element label coincideix amb l'atribut id de l'element input.

<label for="firstname">First name:</label> 
<input id="firstname" name="firstname" type="text">

Una casella de selecció

<input checked id="markuplang" name="computerskills" type="checkbox">
<label for="markuplang">HTML</label>

Un grup de botons d'opció

Un grup petit de botons d'opció relacionats, amb una descripció clara i etiquetes per a cada element individual.

<h1>Doughnut Selection</h1>
<form action="/buy-doughnuts" method="post">
  <fieldset>
    <legend>Pick the doughnut you would like</legend>
    <input id="dn-choc" name="flavor" type="radio" value="chocolate">
    <label for="dn-choc">Chocolate</label>
    <input id="dn-cream" name="flavor" type="radio" value="cream">
    <label for="dn-cream">Cream Filled</label>
    <input id="dn-raspberry" name="flavor" type="radio" value="raspberry">
    <label for="dn-raspberry">Raspberry Filled</label>
  </fieldset>
  <input type="submit" value="Purchase Your Doughnut">
</form>

Proves

Procediment

Per a tots els elements input de tipus text, file o password, per a tots els elements textarea i per a tots els elements select de la pàgina web:

  1. Comprovar que hi ha un element label que identifica la finalitat del control abans de l'element input, textarea o select
  2. Comprovar que l'atribut for de l'element label coincideix amb l'id de l'element input, textarea o select.
  3. Comprovar que l'element label és visible.

Per a tots els elements input de tipus checkbox o radio de la pàgina web:

  1. Comprovar que hi ha un element label que identifica la finalitat del control després de l'element input.
  2. Comprovar que l'atribut for de l'element label coincideix amb l'id de l'element input.
  3. Comprovar que l'element label és visible.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes.
  • Per al criteri de conformitat 3.3.2 (Etiquetes o instruccions), la comprovació núm. 3 també és certa.

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