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

Tècnica ARIA WCAG 2.2

ARIA22Anunciar missatges d'estat amb role="status"

Nom oficial al W3C: Utilitzar role=status per presentar missatges d'estat

Versión en castellano

En poques paraules

Un missatge d'estat informa d'un canvi sense moure el focus: «5 resultats», «Producte afegit a la cistella», «Desat». Si el seu contenidor porta role="status", el lector de pantalla el llegeix quan acaba el que està dient, sense interrompre. Així ningú no es queda sense saber què ha passat.

Per què és important

Qui veu la pantalla nota que el comptador de la cistella canvia o que apareix «5 resultats». Qui utilitza lector de pantalla no s'assabenta d'aquest canvi si ningú no l'hi anuncia.

Moure el focus fins al missatge tampoc no és una bona idea, perquè la persona perd el seu lloc. role="status" resol les dues coses: avisa sense interrompre i sense moure el focus.

Com es fa

  1. Poseu a l'HTML inicial el contenidor del missatge amb role="status". Ha d'existir abans que en canviï el contingut.
  2. Afegiu-hi aria-atomic="true" perquè es llegeixi el missatge sencer i no només la part que canvia. Alguns navegadors no ho apliquen per defecte.
  3. Poseu-hi dins tot el que dona sentit al missatge, com la paraula «Cistella:» o la icona del carretó amb el seu text alternatiu.
  4. Actualitzeu amb JavaScript només el text d'aquest contenidor.
  5. Utilitzeu role="status" per a avisos rutinaris. Deixeu role="alert" per a errors urgents.

Exemple pràctic

Fitxa de producte d'una botiga en línia. Té un indicador de la cistella que canvia en prémer «Afegeix a la cistella». La pàgina no es torna a carregar i el focus no es mou.

Així no: Comptador de la cistella que canvia en silenci

El nombre de productes canvia a la pantalla, però el contenidor no és una regió activa. El lector de pantalla no diu res en prémer el botó. La persona no sap si el producte s'ha afegit. Per notar-ho, activeu NVDA o VoiceOver i premeu el botó.

Captura de pantalla de l'exemple incorrecte: Comptador de la cistella que canvia en silenci
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
<p id="cesta" class="cesta">Cistella: 0 productes</p>
<h2>Oli d'oliva verge extra, 1 l</h2>
<p>8,95 €</p>
<button type="button" id="anadir">Afegeix a la cistella</button>
<style>
  .cesta { font-weight: bold; color: #412c56; }
  h2 { font-size: 1.1em; margin: .5em 0 .2em; }
</style>
<script>
var n = 0;
document.getElementById('anadir').addEventListener('click', function () {
  n++;
  document.getElementById('cesta').textContent = 'Cistella: ' + n + (n === 1 ? ' producte' : ' productes');
});
</script>

Així sí: Missatge d'estat amb role="status"

El contenidor porta role="status" i aria-atomic="true" des de la càrrega. Cada canvi s'anuncia sense interrompre i sense moure el focus. A més, es llegeix el text complet («Cistella: …»), no només el número que canvia.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<p id="cesta" class="cesta" role="status" aria-atomic="true">Cistella: 0 productes</p>
<h2>Oli d'oliva verge extra, 1 l</h2>
<p>8,95 €</p>
<button type="button" id="anadir">Afegeix a la cistella</button>
<style>
  .cesta { font-weight: bold; color: #412c56; }
  h2 { font-size: 1.1em; margin: .5em 0 .2em; }
</style>
<script>
var n = 0;
document.getElementById('anadir').addEventListener('click', function () {
  n++;
  document.getElementById('cesta').textContent = 'Cistella: ' + n + (n === 1 ? ' producte' : ' productes');
});
</script>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. Situar el focus a «Afegeix a la cistella» i prémer Retorn o Espai.
  2. Comprovar que, després de llegir el botó, s'anuncia el nou estat de la cistella sense moure el focus.
  3. Tornar a prémer-lo i verificar que s'anuncia el número actualitzat.

Hauria d'anunciar: «Cistella: 1 producte»

Eines del navegador

  1. Obrir les eines de desenvolupament (F12) a la pestanya Elements.
  2. Comprovar que el contenidor del missatge ja té role="status" a l'HTML inicial, abans de prémer el botó.
  3. A la pestanya Accessibilitat, verificar que la funció és «status».
  4. Comprovar que tot el missatge és dins d'aquest contenidor, inclòs el context («Cistella:» o el text alternatiu d'una icona).

Teclat

  1. Prémer el botó amb el teclat. El focus s'hi ha de quedar: un missatge d'estat no mou el focus (criteri 4.1.3).

Validació automàtica

  1. Les eines automàtiques no detecten un missatge d'estat sense regió activa. El criteri 4.1.3 es revisa a mà.
  2. axe DevTools sí que avisa si l'atribut està mal escrit: valors ARIA no vàlids (aria-valid-attr-value) o funcions que no existeixen (aria-roles).

Errors freqüents en auditories

  • Afegir role="status" al contenidor en el mateix moment en què s'escriu el missatge. Ja és tard perquè s'anunciï.
  • Posar role="status" en un contenidor amb tota la llista de resultats. Es llegeix sencera a cada canvi.
  • Utilitzar role="alert" per a confirmacions rutinàries («Producte afegit»). Interromp el que s'estigui llegint.
  • Deixar fora del contenidor el context visual (icona de la cistella, paraula «Cistella:»). Només s'anuncia un número sense sentit.
Veure el text complet del W3C (traducció al català)

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

Descripció

Aquesta tècnica utilitza la funció (role) status de l'especificació ARIA per notificar a les tecnologies de suport quan el contingut s'ha actualitzat amb informació sobre l'estat de l'usuari o de l'aplicació. Això es fa afegint role="status" a l'element que conté el missatge d'estat. La funció de regió activa (live region) d'ARIA status té un valor implícit d'aria-live igual a polite, cosa que permet que l'usuari rebi una notificació a través de la tecnologia de suport (com ara un lector de pantalla) quan s'afegeixen missatges d'estat. La funció status també té un valor predeterminat d'aria-atomic igual a true, de manera que les actualitzacions del contenidor marcat amb la funció status faran que la tecnologia de suport presenti a l'usuari tot el contingut del contenidor, incloses les etiquetes definides per l'autor (o els elements imbricats addicionals). Aquest context addicional pot ser fonamental quan el text del missatge d'estat per si sol no proporciona un equivalent a l'experiència visual. El contingut del contenidor aria-live el llegeix automàticament la tecnologia de suport, sense que aquesta hagi de situar el focus en el lloc on es mostra el text. Consulteu WAI-ARIA status (role) per a més detalls.

Tingueu en compte que, com que actualment role="status" no es tracta com a atòmic de manera predeterminada en alguns entorns, és recomanable afegir un aria-atomic="true" explícit si s'ha d'anunciar tot el contingut del contenidor.

Exemples

Incloure un missatge amb els resultats d'una cerca

Després que l'usuari premi un botó de cerca, el contingut de la pàgina s'actualitza per incloure els resultats de la cerca, que es mostren en una secció sota el botó. El canvi de contingut també inclou el missatge "5 results returned" (s'han retornat 5 resultats) a prop de la part superior d'aquest contingut nou. A aquest text se li assigna una funció apropiada per a un missatge d'estat. Un lector de pantalla anunciarà "5 results returned".

<div role="status" aria-atomic="true">5 results returned.</div>

Exemple funcional: role=status en resultats de cerca

Actualitzar l'estat del carretó de la compra

Després que l'usuari premi un botó d'afegir al carretó de la compra, el contingut situat al costat de la icona del carretó s'actualitza per mostrar "1 items" (1 articles). El contenidor d'aquest text (en aquest cas un <p>) està marcat amb role="status". Com que aporta context visual, la imatge del carretó de la compra, amb un text alt breu i precís, també es col·loca dins del contenidor. Gràcies al valor d'aria-atomic, un lector de pantalla anunciarà "Shopping cart, six items" (carretó de la compra, sis articles).

<p role="status" aria-atomic="true">
  <img src="shopping-cart.png" alt="Shopping Cart">
  <span id="cart">0</span> items
</p>

Exemple funcional: role=status en un carretó de la compra

Proves

Procediment

Per a cada missatge d'estat:

  1. Comprovar que el contenidor destinat a contenir el missatge d'estat té un atribut role amb el valor status abans que es produeixi el missatge d'estat.
  2. Comprovar que, quan es desencadena el missatge d'estat, aquest es troba dins del contenidor.
  3. Comprovar que els elements o atributs que proporcionen informació equivalent a l'experiència visual del missatge d'estat (com ara una imatge de carretó de la compra amb un text alt adequat) també són dins del contenidor.

Resultats esperats

  • Les comprovacions núm. 1, núm. 2 i núm. 3 són certes.

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