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

Tècnica ARIA WCAG 2.2

ARIA23Anunciar les novetats d'un xat o un historial amb role="log"

Nom oficial al W3C: Utilitzar role=log per identificar actualitzacions d'informació seqüencial

Versión en castellano

En poques paraules

Un xat, un historial d'activitat o un registre d'avisos afegeixen missatges nous al final, l'un darrere l'altre. Si el seu contenidor porta role="log", el lector de pantalla llegeix cada missatge nou quan arriba, sense moure el focus. Només llegeix el que s'ha afegit, no tot l'historial.

Per què és important

En un xat d'atenció al client, la persona escriu en un camp de text. Les respostes apareixen en una altra zona de la pantalla. Si utilitza lector de pantalla i ningú no l'hi anuncia, no sap que li han contestat.

Amb role="log", els missatges nous es llegeixen de manera educada: quan el lector acaba el que està dient. El focus continua en el camp de text.

Com es fa

  1. Poseu role="log" en el contenidor dels missatges des que es carrega la pàgina.
  2. Afegiu cada missatge nou al final, com un element més. No reescriviu tot el contenidor, perquè es tornaria a llegir sencer.
  3. Doneu nom a la zona amb aria-label o aria-labelledby, per exemple «Conversa».
  4. Indiqueu en cada missatge qui l'escriu: «Anna: La vostra comanda surt demà».
  5. Utilitzeu-lo només per a informació que creix en ordre. Per a un missatge que se substitueix per un altre, utilitzeu role="status".

Com comprovar-ho

  1. Localitzeu les zones que afegeixen informació en ordre: xat, historial, registre d'activitat.
  2. Comproveu en el codi que el seu contenidor té role="log".
  3. Activeu un lector de pantalla, deixeu el focus en un altre lloc i provoqueu un missatge nou. Només s'ha de llegir aquest missatge.

Exemple

Xat d'atenció al client en què cada resposta nova s'anuncia en arribar.

<div role="log" aria-label="Conversa amb atenció al client">
  <p><strong>Anna:</strong> Bon dia, en què us puc ajudar?</p>
  <p><strong>Vós:</strong> Vull canviar la data de la meva cita.</p>
  <!-- Els missatges nous s'afegeixen aquí, al final -->
</div>
<label for="mensaje">El vostre missatge</label>
<input id="mensaje">
Veure el text complet del W3C (traducció al català)

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

El propòsit d'aquesta tècnica és notificar a les tecnologies de suport quan s'ha afegit contingut a informació seqüencial relativa a l'historial o als registres (logs) de l'aplicació. La funció (role) de regió activa (live region) d'ARIA log té un valor implícit d'aria-live igual a polite i un valor d'aria-atomic igual a false, 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 al registre. El contingut nou de la regió activa 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 1.3 log (role) per a més detalls.

Exemples

Actualitzar el contingut d'una conversa de xat

Els comentaris que els usuaris escriuen en el camp d'entrada d'un xat s'afegeixen al final de la regió de l'historial del xat. La regió està marcada amb role="log" perquè les tecnologies de suport anunciïn les noves incorporacions. Quan apareix cada missatge de xat nou, un lector de pantalla n'hauria d'anunciar el contingut (segons la compatibilitat entre la tecnologia de suport i el navegador).

<div id="chatRegion" role="log" aria-labelledby="chatHeading">
  <h4 id="chatHeading">Chat History</h4>
  <ul id="conversation">
    <li>The latest chat message</li>
  </ul>
</div>

Exemple funcional: utilitzar role="log" en una conversa de xat

Actualitzar el registre d'un servidor

Un registre d'aplicació desa activitats amb marca de temps. El registre s'exposa a l'aplicació com una vista, amb la regió marcada amb role="log" perquè les tecnologies de suport anunciïn les noves incorporacions. Quan s'afegeix cada entrada nova al registre, un lector de pantalla l'anuncia.

<div id="activityLog" role="log">
  <h4 id="logHeading">Recent activity</h4>
  <ul id="logentries"">
    <li>08:03 UserX logged off</li>
  </ul>
</div>

Exemple funcional: utilitzar role="log" en el registre d'un servidor

Proves

Procediment

En una pàgina que conté informació que s'actualitza de manera seqüencial:

  1. Comprovar que al contenidor de la informació se li assigna la funció log.

Resultats esperats

  • La comprovació núm. 1 és certa.

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