Técnica ARIA WCAG 2.2
ARIA23Usar role=log para identificar actualizaciones de información secuencial
En resumen
En un chat, un historial de actividad o un registro de servidor, las nuevas entradas se van añadiendo al final sin que el usuario interactúe con ellas. Si el contenedor lleva role="log", los lectores de pantalla anuncian cada entrada nueva (y solo la nueva) sin interrumpir ni mover el foco. Úsela siempre que la información crezca de forma secuencial y cronológica.
Descripción
El propósito de esta técnica es notificar a las tecnologías de asistencia cuando se ha añadido contenido a información secuencial relativa al historial o los registros (logs) de la aplicación. La función (role) de región activa (live region) de ARIA log tiene un valor implícito de aria-live igual a polite y un valor de aria-atomic igual a false, lo que permite que el usuario sea notificado a través de la tecnología de asistencia (como un lector de pantalla) cuando se añaden mensajes al registro. El nuevo contenido de la región activa es leído automáticamente por la tecnología de asistencia, sin que esta tenga que situar el foco en el lugar donde se muestra el texto. Consulte WAI-ARIA 1.3 log (role) para más detalles.
Ejemplos
Actualizar el contenido de una conversación de chat
Los comentarios que los usuarios escriben en el campo de entrada de un chat se añaden al final de la región del historial del chat. La región está marcada con role="log" para que las tecnologías de asistencia anuncien las nuevas incorporaciones. Cuando aparece cada nuevo mensaje de chat, un lector de pantalla debería anunciar su contenido (según la compatibilidad entre la tecnología de asistencia y 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>Ejemplo funcional: usar role="log" en una conversación de chat
Actualizar el registro de un servidor
Un registro de aplicación guarda actividades con marca de tiempo. El registro se expone en la aplicación como una vista, con la región marcada con role="log" para que las tecnologías de asistencia anuncien las nuevas incorporaciones. Cuando se añade cada nueva entrada al registro, un lector de pantalla la anuncia.
<div id="activityLog" role="log">
<h4 id="logHeading">Recent activity</h4>
<ul id="logentries"">
<li>08:03 UserX logged off</li>
</ul>
</div>Ejemplo funcional: usar role="log" en el registro de un servidor
Pruebas
Procedimiento
En una página que contiene información que se actualiza de forma secuencial:
- Comprobar que al contenedor de la información se le asigna la función
log.
Resultados esperados
- La comprobación n.º 1 es verdadera.
Cómo lo comprobamos en ADDAW
En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.
Fuente y licencia
Traducción al español, no oficial, realizada por ADDAW a partir de la técnica ARIA23 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.
