Regiones vivas ARIA: anunciar mensajes de estado
También llamado: aria-live, Región viva, Mensaje de estado
Definición
Una región viva ARIA es una parte de la página marcada con aria-live o con un rol de región viva como status o alert. Cuando cambia su contenido, los lectores de pantalla anuncian el texto nuevo sin que el usuario tenga que mover el foco hasta él.
Las regiones vivas ARIA son zonas de una página que indican a la tecnología de apoyo: «anuncie aquí los cambios». Cuando una tienda añade un artículo al carrito, una búsqueda devuelve resultados o un formulario muestra un error junto a un campo, los visitantes videntes lo notan de un vistazo. Un usuario de lector de pantalla solo se entera si el mensaje está en una región viva; de lo contrario, la actualización se produce en silencio.
Qué significa
El criterio WCAG 4.1.3 Mensajes de estado (nivel AA, WCAG 2.2) exige que los mensajes de estado puedan determinarse por software mediante un rol o unas propiedades, de modo que la tecnología de apoyo pueda presentarlos sin que el mensaje reciba el foco. El W3C define un mensaje de estado como un cambio en el contenido que no es un cambio de contexto y que informa del resultado de una acción, de un estado de espera, del avance de un proceso o de la existencia de errores.
Mensajes de estado típicos de los ejemplos del W3C: «5 resultados encontrados» tras una búsqueda, un contador del carrito actualizado, una nota de «Entrada no válida» junto a un campo, un indicador de actividad y una confirmación tras enviar un formulario.
La especificación ARIA ofrece varias formas de marcarlos:
| Marcado | Anuncio | Úselo para |
|---|---|---|
role="status" |
Polite: espera a que el lector de pantalla esté inactivo | Resultados, confirmaciones, contadores del carrito (técnica ARIA22 del W3C) |
role="alert" |
Assertive: interrumpe | Errores y advertencias que requieren atención inmediata (ARIA19) |
role="log" |
Polite, las entradas nuevas se añaden en orden | Mensajes de chat, flujos de actividad (ARIA23) |
aria-live="polite" / "assertive" |
Como arriba, en cualquier contenedor | Componentes personalizados sin un rol adecuado |
El W3C recoge también un fallo: usar role="alert" o aria-live="assertive" en contenido que no es ni importante ni urgente. Las interrupciones constantes hacen que una página resulte agotadora de usar.
Ejemplos
<!-- Good: the region exists from the start, text is added later -->
<p role="status" id="cart-status"></p>
<script>
document.getElementById('cart-status').textContent = '3 items in your cart';
</script>
<!-- Good: an error that needs attention -->
<p role="alert">Payment failed. Please check your card number.</p>
<!-- Bad: visual-only update, never announced -->
<span class="badge">3</span>Incluya la región viva en la página al cargarla y cambie después solo su texto. Mantenga los mensajes cortos («Guardado»), use role="status" para la mayoría de las actualizaciones y reserve role="alert" para los errores reales. Dé a los contadores que solo muestran un icono un texto que el lector de pantalla pueda leer.
Insertar la región viva entera junto con su mensaje, porque muchos lectores de pantalla no la anuncian. Marcar como vivas zonas grandes, como una lista completa de productos, usar assertive para las actualizaciones rutinarias o fiarse solo de un cambio de color o de un indicador numérico.
Cómo comprobar las regiones vivas ARIA
Preguntas frecuentes
¿Qué diferencia hay entre aria-live polite y assertive?
Polite espera a que el lector de pantalla termine lo que está diciendo y entonces lee la actualización. Assertive interrumpe de inmediato. Use polite para casi todo y assertive solo para errores o advertencias urgentes.
¿Es role="status" lo mismo que aria-live="polite"?
Casi. role="status" asigna de forma implícita a la región el valor polite en aria-live y el valor true en aria-atomic, de modo que se lee el mensaje completo. Además, indica a la tecnología de apoyo que el contenido es información de estado orientativa.
¿Por qué mi lector de pantalla no anuncia la región viva?
Lo más habitual es que la región se haya añadido a la página junto con su texto. Los navegadores solo notifican los cambios en regiones que ya existen. Añada un contenedor vacío al cargar la página y rellénelo después. Los contenedores ocultos con display: none tampoco se anuncian.
¿Los mensajes de error de un formulario necesitan una región viva?
Los mensajes de error que se muestran sin mover el foco son mensajes de estado según el criterio WCAG 4.1.3, así que necesitan role="alert" o una región viva. Si en su lugar mueve el foco a un resumen de errores, ese cambio de foco ya hace que el lector de pantalla lo lea. Vincule también cada mensaje con su campo, como se describe en las etiquetas de formulario.
Términos relacionados
ARIA: roles, estados y propiedades explicados
ARIA (WAI-ARIA, Accessible Rich Internet Applications) es una especificación del W3C de atributos HTML (roles, estados y propiedades) que indican a las tecnologías de apoyo qué es un elemento personalizado, cómo se llama y en qué estado se encuentra.
Leer la definición: ARIA: roles, estados y propiedades explicadosLector de pantalla: cómo lee un sitio web y qué necesita
Un lector de pantalla es un software de apoyo que lee en voz alta el contenido y los controles de la pantalla o los envía a una línea braille. Se basa en los nombres, los roles y los estados que un sitio web expone a través del árbol de accesibilidad del navegador.
Leer la definición: Lector de pantalla: cómo lee un sitio web y qué necesitaNombre accesible: qué es y cómo se calcula
El nombre accesible es el texto que los navegadores transmiten a las tecnologías de apoyo para identificar un elemento, por ejemplo las palabras que un lector de pantalla anuncia para un botón, un enlace o un campo de formulario. El criterio WCAG 4.1.2 exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software.
Leer la definición: Nombre accesible: qué es y cómo se calculaaria-label: cómo nombrar correctamente los elementos
aria-label es un atributo ARIA que define el nombre accesible de un elemento como una cadena de texto. Los lectores de pantalla anuncian ese nombre en lugar del contenido del elemento, por lo que se usa sobre todo en controles sin texto visible, como los botones de icono.
Leer la definición: aria-label: cómo nombrar correctamente los elementos