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

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

Versión en castellano

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

  1. Creeu la finestra amb role="alertdialog" i aria-modal="true". També podeu utilitzar l'element <dialog>, obert amb showModal(), i afegir-hi aquest role.
  2. Doneu-li un nom amb aria-labelledby, que apunti al seu títol, o amb aria-label.
  3. Escriviu-hi quina dada és incorrecta i com corregir-la: «La data de la cita ha de ser posterior a avui».
  4. Incloeu-hi almenys un botó, com ara «D'acord», i porteu-hi el focus en obrir la finestra.
  5. Mentre estigui oberta, el tabulador no ha de sortir de la finestra.
  6. En tancar-la, torneu el focus, si és possible, al lloc on era abans.

Com comprovar-ho

  1. Provoqueu l'error, per exemple enviant el formulari amb una dada mal escrita.
  2. Comproveu que el focus passa a un element de la finestra, com ara el seu botó.
  3. Premeu el tabulador diverses vegades. El focus no ha de sortir de la finestra.
  4. Tanqueu la finestra i comproveu que el focus torna on era.
  5. 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-label o aria-labelledby proporciona un nom accessible a l'alertdialog.
  • L'alertdialog conté 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'alertdialog mentre 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

  1. Provocar l'error que fa que aparegui l'alertdialog.
  2. Determinar que l'alertdialog conté almenys un element focalitzable i que el focus es desplaça a aquest element quan s'obre l'alertdialog.
  3. Si s'utilitza un element dialog no natiu: determinar que l'ordre de tabulació queda restringit a l'interior de l'alertdialog mentre 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.
  4. Examinar l'element al qual s'ha aplicat alertdialog.
  5. Determinar que s'ha utilitzat correctament l'atribut aria-label o aria-labelledby per donar un nom accessible a l'alertdialog.
  6. Determinar que el contingut de l'alertdialog identifica l'error d'entrada.
  7. Determinar si el contingut de l'alertdialog suggereix 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

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