# Mensajes de estado: anunciar cambios sin mover el foco

Source: https://allyway.ai/es/glossary/mensajes-de-estado

Los mensajes de estado son cambios en el contenido que informan al usuario del resultado de una acción, de un estado de espera, del avance de un proceso o de la existencia de errores, sin cambiar el contexto. El criterio WCAG 4.1.3 exige que puedan determinarse por software, de modo que las tecnologías de apoyo los presenten sin darles el foco.

Los mensajes de estado son las actualizaciones breves que muestra una página después de que ocurre algo: «5 resultados encontrados», «Añadido al carrito», «Su formulario se ha enviado». Los usuarios videntes los ven aparecer; los usuarios de lector de pantalla solo los oyen si la página los marca correctamente. De lo contrario, el mensaje aparece en silencio y la persona se queda preguntándose si el clic ha funcionado.

## 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, en el contenido implementado con lenguajes de marcado, los mensajes de estado puedan determinarse por software mediante un rol o unas propiedades, de modo que las tecnologías de apoyo puedan presentarlos al usuario sin que reciban 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 al usuario del éxito o del resultado de una acción, del estado de espera de una aplicación, del avance de un proceso o de la existencia de errores. Un cuadro de diálogo que recibe el foco o una página nueva son un cambio de contexto y, por tanto, quedan fuera.

| Tipo de mensaje | Ejemplo | ARIA adecuado |
|---|---|---|
| Resultado o éxito | «5 resultados encontrados», «Guardado» | `role="status"` (ARIA22) |
| Error o advertencia | «3 campos requieren su atención» | `role="alert"` o una región viva (ARIA19) |
| Actualizaciones secuenciales | Historial de chat, flujo de actividad | `role="log"` (ARIA23) |
| Avance | «Carga completada al 60 %» | Región viva para la barra de progreso (ARIA25) |
| Estado de espera | «Aplicación ocupada» | `role="status"` |

> **Tip:** > **Polite por defecto**
> `role="status"` se anuncia cuando el lector de pantalla está inactivo. Reserve `role="alert"` para los mensajes importantes y urgentes; el W3C recoge como fallo usarlo en contenido sin importancia.

El criterio ayuda sobre todo a las personas ciegas y con baja visión que usan un [lector de pantalla](https://allyway.ai/es/glossary/lector-de-pantalla). El W3C señala también que las tecnologías de apoyo para algunas discapacidades cognitivas pueden usar estos roles para retrasar o suprimir mensajes.

## Ejemplos

```html title="Ejemplo"
<!-- The container exists when the page loads, empty -->
<div role="status" id="search-status"></div>

<script>
  // After filtering, only the text changes
  document.getElementById('search-status').textContent = '5 results returned';
</script>
```

El contenedor vacío está en la página desde el principio y solo cambia su texto. Muchos lectores de pantalla ignoran una región viva que se inserta junto con su mensaje. Los fundamentos de `aria-live` se explican en la entrada sobre las [regiones vivas ARIA](https://allyway.ai/es/glossary/regiones-vivas-aria).

**Do:** Qué hacer

Ponga el mensaje en un contenedor `role="status"` que exista antes de que cambie, mantenga el texto breve y completo («Artículo añadido al carrito») y use `role="alert"` solo para los errores que requieren atención inmediata, junto con una [identificación de errores](https://allyway.ai/es/glossary/identificacion-de-errores) clara.

**Don't:** Qué evitar

Mostrar un aviso emergente (toast) que desaparece sin ningún rol, mover el foco con cada mensaje de «Guardado», marcar como región viva toda la lista de resultados o usar `aria-live="assertive"` para novedades menores.

## Cómo comprobar los mensajes de estado



## Preguntas frecuentes

Q: ¿Qué es un mensaje de estado en las WCAG?
A: Un cambio en el contenido que informa al usuario del éxito o del resultado de una acción, de un estado de espera, del avance de un proceso o de la existencia de errores, sin cambiar el contexto, es decir, sin mover el foco ni abrir una ventana nueva.

Q: ¿Qué diferencia hay entre role="status" y role="alert"?
A: `role="status"` es polite: el lector de pantalla lo anuncia cuando ha terminado de hablar. `role="alert"` es assertive e interrumpe. Use alert solo para información importante y urgente, como un error que bloquea el paso siguiente.

Q: ¿Los mensajes de error cuentan como mensajes de estado?
A: Sí, si aparecen sin mover el foco, por ejemplo «3 campos requieren su atención» sobre un formulario. Un error mostrado en un cuadro de diálogo que recibe el foco es un cambio de contexto y no entra en el criterio 4.1.3.

Q: ¿Por qué mi lector de pantalla no lee el aviso emergente (toast)?
A: Normalmente, la región viva se añade a la página junto con el mensaje, o el aviso no tiene ningún rol. Mantenga en la página un contenedor `role="status"` vacío y cambie solo su texto.

Q: ¿Forma parte el criterio WCAG 4.1.3 de la Ley Europea de Accesibilidad?
A: La [Ley Europea de Accesibilidad](https://allyway.ai/es/regulations/eaa) remite a la norma EN 301 549, que incorpora el nivel AA de las WCAG 2.1 para la web, incluido el criterio 4.1.3 como cláusula 9.4.1.3.
