# Regiones vivas ARIA: anunciar mensajes de estado

Source: https://allyway.ai/es/glossary/regiones-vivas-aria

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](https://allyway.ai/es/glossary/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](https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html) (nivel AA, [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2)) exige que los [mensajes de estado](https://allyway.ai/es/glossary/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](https://allyway.ai/es/glossary/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 |

> **Note:** > **No todo es un mensaje de estado**
> Los mensajes de un cuadro de diálogo que recibe el foco, una página nueva o un menú que se abre quedan fuera del criterio 4.1.3. Los componentes desplegables están cubiertos, en cambio, por el criterio 4.1.2 [Nombre, función, valor](https://allyway.ai/es/glossary/nombre-funcion-valor); véase [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible).

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

```html title="Ejemplo"
<!-- 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>
```

**Do:** Qué hacer

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.

**Don't:** Qué evitar

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

Q: ¿Qué diferencia hay entre aria-live polite y assertive?
A: 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.

Q: ¿Es role="status" lo mismo que aria-live="polite"?
A: 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.

Q: ¿Por qué mi lector de pantalla no anuncia la región viva?
A: 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.

Q: ¿Los mensajes de error de un formulario necesitan una región viva?
A: Los [mensajes de error](https://allyway.ai/es/glossary/identificacion-de-errores) 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](https://allyway.ai/es/glossary/etiquetas-de-formulario).
