Tècnica ARIA WCAG 2.2
ARIA18Avisar d'errors amb una finestra d'alerta (role="alertdialog")
Nom oficial al W3C: Utilitzar aria-alertdialog per identificar errors
En poques paraules
Quan algú envia un formulari amb una dada incorrecta, se'l pot avisar amb una finestra d'alerta que bloqueja la resta de la pàgina. Amb role="alertdialog", el lector de pantalla l'anuncia en obrir-se. El focus entra a la finestra, s'hi queda a dins i, en tancar-la, torna on era.
Per què és important
Un avís d'error que només es veu no serveix a qui utilitza lector de pantalla. Aquesta persona pot continuar en el botó «Envia» sense assabentar-se que alguna cosa ha fallat.
Una finestra amb role="alertdialog" s'anuncia en obrir-se i rep el focus. La persona sap quin error hi ha i, si el missatge ho explica, com corregir-lo. També ajuda qui navega amb teclat, perquè no es perd per la pàgina.
Com es fa
- Creeu la finestra amb
role="alertdialog"iaria-modal="true". També podeu utilitzar l'element<dialog>, obert ambshowModal(), i afegir-hi aquestrole. - Doneu-li un nom amb
aria-labelledby, que apunti al seu títol, o ambaria-label. - Escriviu-hi quina dada és incorrecta i com corregir-la: «La data de la cita ha de ser posterior a avui».
- Incloeu-hi almenys un botó, com ara «D'acord», i porteu-hi el focus en obrir la finestra.
- Mentre estigui oberta, el tabulador no ha de sortir de la finestra.
- En tancar-la, torneu el focus, si és possible, al lloc on era abans.
Com comprovar-ho
- Provoqueu l'error, per exemple enviant el formulari amb una dada mal escrita.
- Comproveu que el focus passa a un element de la finestra, com ara el seu botó.
- Premeu el tabulador diverses vegades. El focus no ha de sortir de la finestra.
- Tanqueu la finestra i comproveu que el focus torna on era.
- Amb un lector de pantalla, confirmeu que s'anuncien el nom de la finestra i l'error, i que el text explica com corregir-lo.
Exemple
Finestra d'alerta que explica un error en el formulari de cita prèvia.
<div role="alertdialog" aria-modal="true"
aria-labelledby="tit-error" aria-describedby="txt-error">
<h2 id="tit-error">Hi ha un error en el formulari</h2>
<p id="txt-error">
La data de la cita ha de ser posterior a avui.
Escriviu-la amb el format dd/mm/aaaa.
</p>
<button type="button">D'acord</button>
</div>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica ARIA18 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ó
El propòsit d'aquesta tècnica és avisar les persones que s'ha produït un error d'entrada. L'ús de role="alertdialog" crea una notificació. Aquesta notificació ha de ser modal i tenir les característiques següents:
- L'atribut
aria-labeloaria-labelledbyproporciona un nom accessible a l'alertdialog. - L'
alertdialogconté almenys un element focalitzable, i el focus s'ha de desplaçar a aquest element quan s'obre l'alertdialog. - L'ordre de tabulació queda restringit a l'interior de l'
alertdialogmentre està obert. - Quan es tanca l'
alertdialog, el focus torna, si és possible, a la posició que tenia abans que s'obrís l'alertdialog.
Exemples
Diàleg d'alerta
Aquest exemple mostra com es pot utilitzar una notificació amb role="alertdialog" per avisar algú que ha introduït informació no vàlida.
<dialog aria-labelledby="alert-heading" id="date-alert" role="alertdialog">
<h1 id="alert-heading">Error</h1>
<p>Employee's Birth Date is after their hire date. Please verify the birth date and hire date.</p>
<button command="close" commandfor="date-alert" type="button">Return to page and correct error</button>
</dialog>
Exemple funcional: Utilitzar aria-alertdialog per identificar errors
.
Proves
Procediment
- Provocar l'error que fa que aparegui l'
alertdialog. - Determinar que l'
alertdialogconté almenys un element focalitzable i que el focus es desplaça a aquest element quan s'obre l'alertdialog. - Si s'utilitza un element
dialogno natiu: determinar que l'ordre de tabulació queda restringit a l'interior de l'alertdialogmentre està obert i que, quan es tanca l'alertdialog, el focus torna, si és possible, a la posició que tenia abans que s'obrís l'alertdialog. - Examinar l'element al qual s'ha aplicat
alertdialog. - Determinar que s'ha utilitzat correctament l'atribut
aria-labeloaria-labelledbyper donar un nom accessible a l'alertdialog. - Determinar que el contingut de l'
alertdialogidentifica l'error d'entrada. - Determinar si el contingut de l'
alertdialogsuggereix com corregir l'error.
Resultats esperats
- Les comprovacions núm. 2, núm. 3, núm. 5 i núm. 6 són certes. Per al criteri de conformitat 3.3.3 Suggeriments davant d'errors, la comprovació núm. 7 també és certa.
Recursos
- WAI-ARIA Authoring Practices Guide (guia de pràctiques d'autor de WAI-ARIA)
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 ARIA18 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.