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

Tècnica ARIA WCAG 2.2

ARIA6Donar nom a un element amb aria-label quan no hi ha text visible

Nom oficial al W3C: Utilitzar aria-label per proporcionar etiquetes als objectes

Versión en castellano

En poques paraules

L'atribut aria-label dona un nom invisible a un element: un botó que només té una icona, un menú o una zona de la pàgina. El lector de pantalla llegeix aquest nom perquè la persona sàpiga què és. S'utilitza quan a la pàgina no hi ha cap text visible que serveixi de nom.

Per què és important

Molts webs utilitzen icones sense text: la lupa del cercador, la cistella o les tres ratlles del menú. Qui veu la pantalla les reconeix pel dibuix. Un lector de pantalla (programa que llegeix en veu alta la pantalla), en canvi, només diu «botó».

També ajuda quan hi ha dos menús a la mateixa pàgina. Amb noms com «Menú principal» i «Menú del peu», la persona sap en quin és.

Com es fa

  1. Afegiu aria-label amb un text curt que digui què fa o què és l'element, per exemple aria-label="Cerca".
  2. Utilitzeu-lo en elements que admeten nom: botons, enllaços, camps, regions com <nav> o elements amb un role. En un <div> o <span> sense rol no funciona.
  3. Si ja hi ha un text visible que serveix de nom, és millor utilitzar <label> o aria-labelledby.
  4. Recordeu que aria-label substitueix el nom propi de l'element, com l'alt d'una imatge o el <label> d'un camp.
  5. Si l'element també té aria-labelledby, aquest té prioritat i aria-label s'ignora.
  6. Escriviu el text en l'idioma de la pàgina i sense la paraula «botó»: el lector ja n'anuncia el tipus.

Exemple pràctic

Capçalera d'una botiga en línia amb tres botons: cercar, cistella i menú. Cada botó mostra només una icona SVG. A la pàgina no hi ha cap text que pugui servir de nom a aquests botons.

Així no: Botons d'icona sense nom

Les icones estan ocultes per als lectors de pantalla i els botons no tenen text. Per això el lector diu «botó» tres vegades, sense explicar què fa cadascun. Per notar-ho, recorreu la barra amb la tecla Tab i NVDA o VoiceOver activats.

Captura de pantalla de l'exemple incorrecte: Botons d'icona sense nom
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
<div class="barra">
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
  </button>
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
</div>
<style>
  .barra { display: flex; gap: .5em; }
  .barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
  .barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>

Així sí: Botons amb nom gràcies a aria-label

Cada botó porta un aria-label que en diu la funció: «Cerca», «Cistella» i «Menú». La icona continua oculta amb aria-hidden. Així el nom surt només d'aria-label i no es repeteix.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<div class="barra">
  <button type="button" aria-label="Cerca">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
  <button type="button" aria-label="Cistella">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
  </button>
  <button type="button" aria-label="Menú">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
</div>
<style>
  .barra { display: flex; gap: .5em; }
  .barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
  .barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Recorreu la barra amb la tecla Tab i escolteu com s'anuncia cada botó.
  2. Comproveu que el text d'aria-label diu amb exactitud què fa el botó.

Hauria d'anunciar: «Cerca, botó»; «Cistella, botó»; «Menú, botó»

Eines del navegador

  1. Obriu les eines de desenvolupament (F12), aneu al tauler «Accessibilitat» i seleccioneu cada botó.
  2. Comproveu que el nom («Name») surt d'aria-label i no és buit.
  3. Comproveu que el botó no té també aria-labelledby. Si en tingués, tindria prioritat sobre aria-label i aquest s'ignoraria.

Teclat

  1. Recorreu els botons amb la tecla Tab. Cadascun ha de mostrar un indicador de focus visible, és a dir, el requadre que marca on és.

Validació automàtica

  1. axe DevTools detecta els botons sense nom de l'exemple incorrecte (regla button-name). WAVE els marca com a «Empty button».
  2. Aquestes eines no saben si el text d'aria-label és adequat. Un aria-label="icona" o «botó 1» passa la prova automàtica.

Errors freqüents en auditories

  • Posar aria-label en un div o un span sense funció. Aquí no està permès i els lectors de pantalla l'ignoren.
  • Posar en un botó o un enllaç un aria-label diferent del seu text visible. El nom ha de contenir el text visible (criteri 2.5.3).
  • Deixar noms en anglès o copiats del nom de la icona («search», «icon-cart») en una pàgina en català.
  • Tenir diverses regions nav sense aria-label, o totes amb el mateix. Així no es poden distingir a la llista de regions.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA6 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 compatibles amb Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és proporcionar als objectes una etiqueta que les tecnologies de suport puguin llegir. L'atribut aria-label proporciona l'etiqueta textual d'un objecte, com ara un botó. Quan un lector de pantalla troba l'objecte, llegeix el text d'aria-label, de manera que l'usuari sap de què es tracta.

Qui desenvolupa ha de tenir en compte que les tecnologies de suport poden ignorar aria-label quan s'utilitza aria-labelledby en el mateix objecte. Per a més informació sobre la jerarquia d'assignació de noms, consulteu la secció accessible name and description computation de la recomanació Accessible Name And Description Computation. També ha de tenir en compte que l'ús d'aria-label anul·larà qualsevol mecanisme natiu d'assignació de nom, com l'alt de les imatges o el label associat a un camp de formulari mitjançant l'atribut for.

Exemples

Distingir regions de navegació

L'exemple següent mostra com es podria utilitzar aria-label per distingir dues regions (landmarks) de navegació en un document HTML, quan hi ha més de dues regions del mateix tipus a la mateixa pàgina i no hi ha cap text al qual es pugui fer referència com a etiqueta.

<div role="navigation" aria-label="Primary">
  <ul>
    <li>...a list of links here ...</li>
  </ul>
</div>
<div role="navigation" aria-label="Secondary">
  <ul>
    <li>...a list of links here ...</li>
  </ul>
</div>

Identificar regions genèriques

L'exemple següent mostra com es podria afegir una regió (landmark) genèrica "region" a un portlet meteorològic. No hi ha a la pàgina cap text al qual es pugui fer referència com a etiqueta, així que s'etiqueta amb aria-label.

<div role="region" aria-label="weather portlet"> 
  ...
</div>

Proporcionar una etiqueta a contingut matemàtic

A continuació es mostra un exemple d'una funció en MathML, que utilitza el rol math, una etiqueta adequada i la representació en MathML:

<div role="math" aria-label="6 divided by 4 equals 1.5">
  <math xmlns="https://www.w3.org/1998/Math/MathML">
    <mfrac>
      <mn>6</mn>
      <mn>4</mn>
    </mfrac>
      <mo>=</mo>
      <mn>1.5</mn>
  </math>
</div>

Proves

Procediment

Per a cada element en què hi hagi un atribut aria-label.

  1. Examinar si la descripció textual etiqueta amb precisió l'objecte, en descriu el propòsit o proporciona informació equivalent.

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