Error habitual WCAG 2.2
F103Missatges d'estat que el lector de pantalla no anuncia
Nom oficial al W3C: Error del criteri de conformitat 4.1.3 a causa de proporcionar missatges d'estat que no es poden determinar per programari mitjançant funcions o propietats
En poques paraules
Un missatge d'estat és un avís que apareix sense moure el focus: «Producte afegit al carretó», «0 resultats», «S'està enviant…». L'error és mostrar-lo sense marcar-lo amb role="status", role="alert", role="log" o aria-live. Així el lector de pantalla no el llegeix i la persona no se n'assabenta.
Per què és important
Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) llegeix la part de la pàgina on és l'usuari. Si un avís apareix en un altre lloc, no l'anuncia per si sol.
Així, una persona cega prem «Cerca» i no sap si hi ha resultats. O envia un formulari de cita prèvia i no sent que falta una dada. Ha de recórrer la pàgina sencera per endevinar què ha passat.
Com evitar-ho
- Localitzeu els missatges d'estat: textos que apareixen després d'una acció, sense moure el focus, i que informen d'un resultat, una espera, un progrés o un error.
- Poseu al contenidor del missatge
role="status"per als avisos normals, orole="alert"per als errors i els avisos urgents. - Per a zones que es van ampliant, com un xat o un historial, feu servir
role="log". També serveixenaria-live="polite",aria-live="assertive"o l'element<output>. - Aquest contenidor ha de ser a la pàgina des del principi, encara que estigui buit. Després, canvieu-ne només el text. Si es crea alhora que el missatge, molts lectors de pantalla no el llegeixen.
- Si l'avís rep el focus o porta a una altra pàgina, no és un missatge d'estat i no necessita aquestes marques.
Com comprovar-ho
- Fer les accions que mostren avisos: cercar, afegir al carretó, enviar un formulari, pujar un fitxer.
- Confirmar que l'avís apareix sense moure el focus i que informa d'un resultat, una espera, un progrés o un error.
- Amb les eines del navegador (F12), revisar si el contenidor ja tenia
role="status",alert,logoaria-liveabans que aparegués el text. - Repetir l'acció amb un lector de pantalla (NVDA, JAWS o VoiceOver). Si no anuncia l'avís, hi ha un error.
Exemple
Codi correcte: la zona de l'avís existeix buida des del principi i l'script només en canvia el text.
<form role="search">
<label for="q">Cerca al web</label>
<input id="q" type="search">
<button>Cerca</button>
</form>
<p id="aviso" role="status"></p>
<script>
// Després de fer la cerca:
document.getElementById('aviso').textContent =
'No hi ha resultats per a la vostra cerca.';
</script>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica F103 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 descriure un error en què es fan servir missatges d'estat en el contingut però no es comuniquen a l'usuari per falta de les funcions (rols) o propietats adequades.
El primer pas per confirmar un error de Missatges d'estat és comprovar que el nou contingut dinàmic s'ajusta a la definició de missatge d'estat. Hi ha dos criteris que determinen si el contingut modificat d'una pàgina constitueix un missatge d'estat:
- el nou contingut no rep el focus (no canvia el context);
- el nou contingut proporciona a l'usuari informació sobre el resultat d'una acció, l'estat d'una aplicació, el progrés d'un procés o l'existència d'errors.
El segon pas d'aquesta tècnica d'error consisteix a examinar el codi. Quan el contingut dinàmic s'ajusta a la definició de missatge d'estat, se'n pot examinar el contenidor a la recerca d'una funció (role) o propietat WAI-ARIA adequada que permeti determinar-lo per programari com a missatge d'estat. Actualment només hi ha un petit nombre de tècniques disponibles per indicar missatges d'estat a les tecnologies de suport. Són les següents:
- l'element
outputd'HTML role="status"role="alert"role="log"- l'ús d'un atribut
aria-liveen un element, amb el valor «polite» o «assertive»
Com que hi pot haver tècniques addicionals per alertar una tecnologia de suport, l'últim pas d'aquesta tècnica d'error consisteix a confirmar si una tecnologia de suport (com ara un lector de pantalla) detecta el contingut dinàmic i exposa la informació als usuaris. Quan hi ha un missatge d'estat però la tecnologia de suport no el fa aflorar, es confirma que s'ha produït un error.
Exemples
Incloure un missatge de resultats de cerca sense la funció status
Quan un usuari fa una cerca prement un botó «Search» (cerca), el contingut de la pàgina s'actualitza amb els resultats de la cerca, que es mostren en una secció situada sota el botó. Com que la cerca no obté resultats, el canvi en el contingut transmet el missatge d'estat «0 results returned» (s'han retornat 0 resultats). A aquest text no se li assigna una funció adequada per a un missatge d'estat, per la qual cosa un lector de pantalla no anunciarà «Zero results returned» (zero resultats retornats) llevat que l'usuari es desplaci fins a aquest text. Com que el missatge d'estat no es presenta automàticament a l'usuari (és a dir, la persona l'ha de descobrir manualment), no compleix el criteri de conformitat 4.1.3.
Exemple pràctic: missatge de resultats de cerca sense la funció adequada
Proves
Procediment
Per al contingut que s'afegeix dinàmicament a la pàgina:
- Comprovar que l'element que conté el contingut actualitzat no rep el focus.
- Comprovar que el nou contingut proporciona a l'usuari informació sobre algun dels aspectes següents:
- l'èxit o el resultat d'una acció
- l'estat d'espera d'una aplicació
- el progrés d'un procés
- l'existència d'errors
- Comprovar que l'element que conté el nou contingut no té prèviament una funció (role) ARIA
status,alertolog, ni un atributaria-live. - Comprovar que la tecnologia de suport no fa aflorar (és a dir, no anuncia) el missatge d'estat.
Resultats esperats
- Si les comprovacions núm. 1 a núm. 4 són totes certes, aleshores el contingut no compleix el criteri de conformitat.
Com ho comprovem a ADDAW
Aquest error és un dels que busquem en cada auditoria d'ADDAW. Us el lliurem amb captures i la manera de corregir-lo.
Basat en la tècnica F103 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.