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

Tècnica ARIA WCAG 2.2

ARIA14Donar nom amb aria-label a un control que no té text visible

Nom oficial al W3C: Utilitzar aria-label per proporcionar una etiqueta invisible quan no es pot utilitzar una etiqueta visible

Versión en castellano

En poques paraules

Alguns botons només mostren un símbol, com ara una «×» per tancar o una lupa per cercar. L'atribut aria-label els dona un nom en text que els lectors de pantalla llegeixen en veu alta. Així la persona sap per a què serveix el control encara que no el pugui veure.

Per què és important

Qui veu la pantalla entén pel context que la «×» tanca una finestra. Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) no interpreta dibuixos. Només llegeix noms en text.

Si el botó no té nom, la persona sent «botó» i res més. No sap si tanca, esborra o envia. Amb aria-label="Tanca" sent «Tanca, botó».

Com es fa

  1. Utilitzeu aria-label només quan no hi hagi un text visible que pugui servir de nom. Si n'hi ha, és millor <label> o aria-labelledby.
  2. Poseu-lo en elements que admeten nom: botons, enllaços, camps, regions o elements amb un role interactiu. En un <div> o <span> sense funció, els lectors de pantalla l'ignoren.
  3. Escriviu un text breu que digui què fa el control: «Tanca», «Cerca», «Obre el menú». No descrigueu el dibuix («Aspa», «Lupa»).
  4. No afegiu el tipus de control al text. El lector ja diu «botó» o «enllaç».
  5. També serveix en controls fets a mida que no poden utilitzar <label>, com ara un editor creat amb <div contenteditable>.
  6. Aquest text no es veu a la pantalla. En traduir o revisar el web, no us n'oblideu.

Com comprovar-ho

  1. Cerqueu al codi els elements amb aria-label.
  2. Llegiu-ne el valor i confirmeu que explica per a què serveix el control.
  3. Comproveu que l'element admet nom (botó, enllaç, camp…) i no és un <div> genèric.
  4. Recorreu la pàgina amb el tabulador i un lector de pantalla (NVDA o VoiceOver). Cada control s'ha d'anunciar amb el seu nom, per exemple «Tanca, botó».
  5. A les eines del navegador (F12), pestanya Accessibilitat, reviseu el nom («Name») de l'element.

Exemple

Finestra d'avís amb un botó de tancament que només mostra «×».

<div role="dialog" aria-labelledby="tit-aviso">
  <h2 id="tit-aviso">Cita confirmada</h2>
  <p>La vostra cita és el dilluns 3 a les 10.00.</p>
  <button type="button" aria-label="Tanca">×</button>
</div>
Veure el text complet del W3C (traducció al català)

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

Tecnologies que admeten Accessible Rich Internet Applications (WAI-ARIA).

Descripció

Per a les persones vidents, el context i l'aspecte visual d'un element poden oferir pistes suficients per determinar-ne el propòsit. Un exemple és el símbol «×» que se sol utilitzar a la cantonada superior dreta dels diàlegs per indicar el control que els tanca. Tot i que visualment quedi clar que el botó amb el símbol «×» tanca el diàleg, qui utilitza tecnologies de suport depèn de noms accessibles que comuniquin amb claredat el propòsit dels components, en aquest cas «Tanca».

Quan no hi ha disponible una etiqueta de text visible clara per decisions de disseny, el nom accessible es pot establir en el seu lloc mitjançant l'atribut aria-label, sempre que l'element tingui, implícitament o explícitament, una funció (role) que admeti rebre nom.

L'atribut aria-label també es pot utilitzar per proporcionar un nom accessible a controls personalitzats que no són elements etiquetables i que, per tant, no poden utilitzar un element <label> amb l'atribut for.

Per exemple, aria-label o aria-labelledby són la manera més adequada de proporcionar un nom accessible quan es fa editable un element <div> mitjançant l'atribut contentEditable, en lloc d'elements de formulari nadius com <input type="text"> o <textarea>, per oferir una experiència d'edició de text més rica.

Exemples

Un botó de tancament en un diàleg

En una pàgina, un botó mostra un diàleg (un element <div>) amb informació addicional. L'element de «tancament» s'implementa com un <button> que conté únicament el símbol «×». La propietat aria-label="close" s'utilitza per proporcionar un nom accessible al botó.

<dialog id="dialog">
  This is the content of the dialog.
  <button aria-label="Close">×</button>
</dialog>

Exemple funcional: Exemple de botó de tancament.

Un número de telèfon amb diversos camps

<div role="group" aria-labelledby="groupLabel">
  <span id="groupLabel">Work Phone</span>
  +<input autocomplete="tel-country-code" type="number" aria-label="country code">
  <input autocomplete="tel-area-code" type="number" aria-label="area code">
  <input autocomplete="tel-local" type="number" aria-label="subscriber number">
</div>

Proves

Procediment

Per als elements que utilitzen l'atribut aria-label:

  1. Comprovar que el valor de l'atribut aria-label descriu adequadament el propòsit de l'element en què es requereix l'entrada de l'usuari.

Resultats esperats

  • La comprovació núm. 1 é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 ARIA14 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.