Tècnica ARIA WCAG 2.2
ARIA25Anunciar el progrés d'una pujada de fitxers amb una regió activa
Nom oficial al W3C: Utilitzar una regió activa d'ARIA per transmetre l'estat d'una barra de progrés
En poques paraules
Mentre es puja un fitxer, una barra mostra quant falta. Qui utilitza lector de pantalla no s'assabenta d'aquest avanç si no se li anuncia. La solució és repetir el progrés en un text dins d'una regió activa (aria-live), que el lector llegeix sense que el focus es mogui.
Per què és important
En pujar el PDF d'una sol·licitud, una persona cega no veu avançar la barra. No sap si la pujada va bé, s'ha aturat o ha acabat.
Una barra amb role="progressbar" desa el seu valor, però els lectors de pantalla no avisen quan canvia. Cal un missatge d'estat en una regió activa (zona els canvis de la qual es llegeixen automàticament).
Com es fa
- Mostreu el progrés amb
<progress>o amb un element ambrole="progressbar"i els seus valors (aria-valuenow,aria-valuemin,aria-valuemax). - Afegiu des de la càrrega un contenidor amb
aria-live="polite"orole="status". El podeu amagar a la vista amb una classe com arasr-only. - Escriviu-hi l'avanç amb JavaScript: «Pujada al 50 %».
- No l'actualitzeu a cada instant. Feu-ho cada cert percentatge, per exemple cada 25 %, per no saturar.
- En acabar, anuncieu el resultat: «Fitxer pujat correctament».
- No moveu el focus a la barra ni al missatge.
Com comprovar-ho
- Busqueu a la pàgina barres de progrés que canvien soles, com les de pujar fitxers.
- Activeu un lector de pantalla i comenceu una pujada.
- Comproveu que s'anuncien els avanços i el final sense que el focus es mogui.
- En el codi, confirmeu que el text del progrés és en un contenidor amb
aria-liveorole="status"des de la càrrega.
Exemple
Barra de pujada amb un avís ocult que el lector de pantalla anuncia en canviar.
<label for="subida">Progrés de la pujada</label>
<progress id="subida" max="100" value="50">50 %</progress>
<p id="aviso-subida" class="sr-only" aria-live="polite">Pujada al 50 %</p>
<script>
// Cada 25 %, actualitzar l'avís:
document.getElementById('aviso-subida').textContent = 'Pujada al 75 %';
</script>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica ARIA25 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 mostra com utilitzar una regió activa (live region) d'ARIA per transmetre per programari a les tecnologies de suport l'estat d'una barra de progrés de pujada de fitxers.
Exemple
Aquest exemple simula el progrés de la pujada d'un document. El progrés de la pujada es comunica visualment a l'usuari amb una barra de progrés. A mesura que la barra de progrés s'actualitza, també s'actualitza un text en un contenidor amagat visualment. Aquest contenidor té un atribut aria-live="polite". Aquest atribut indica als lectors de pantalla que anunciïn les actualitzacions fetes en el contingut de l'element.
L'exemple següent utilitza un element amb un atribut role="progressbar". Els valors aria-valuemin, aria-valuemax i aria-valuenow del component progressbar comuniquen per programari el progrés de la pujada, però, com que la funció progressbar no és una regió activa, els lectors de pantalla no anunciaran les actualitzacions d'aquests valors quan canviïn. L'ús d'una barra de progrés d'ARIA no és realment el que importa en aquesta tècnica: el que importa és que el progrés es transmeti mitjançant un missatge d'estat.
El codi següent també es pot veure com a exemple funcional.
<div class="upload-container">
<p id="upload-progress-label">Uploading document: <strong>report.pdf</strong></p>
<div
aria-labelledby="upload-progress-label"
role="progressbar"
aria-describedby="progress-text"
aria-valuemin="0"
aria-valuemax="100"
aria-valuenow="0"
id="upload-progress"></div>
<button id="start-upload" type="button">Start Upload</button>
<div aria-live="polite" class="visually-hidden" id="progress-text">0% complete</div>
</div>
Proves
Procediment
- Verificar si la pàgina conté una barra de progrés que canvia dinàmicament per transmetre visualment informació d'estat a l'usuari.
- Amb un lector de pantalla, comprovar que les actualitzacions de la barra de progrés es transmeten a l'usuari sense que el focus es mogui per programari a la barra de progrés o al missatge d'estat
Resultats esperats
- Les comprovacions núm. 1 i núm. 2 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.
Basat en la tècnica ARIA25 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.