Técnica ARIA WCAG 2.2
ARIA27Anunciar el avance de una barra de progreso con ariaNotify
Nombre oficial en el W3C: Usar ariaNotify para transmitir el estado de una barra de progreso
En pocas palabras
ariaNotify es una función nueva de JavaScript que pide al lector de pantalla que lea un mensaje en voz alta. Sirve para avisar del avance de una subida de archivos sin mover el foco. Todavía es experimental, así que debe usarse como mejora añadida a una región viva.
Por qué es importante
Una barra de progreso suele cambiar solo de forma visual. Una persona ciega que sube un documento no sabe si la subida avanza, se ha parado o ha terminado.
Si el aviso llega al lector de pantalla (programa que lee en voz alta lo que hay en la pantalla), la persona puede seguir trabajando y enterarse del resultado. Esto pide el criterio de mensajes de estado.
Cómo se hace
- Tenga una barra de progreso visible y con nombre, por ejemplo con
<progress>y su etiqueta. - Cuando el avance cambie de forma importante, llame a
ariaNotify()con un texto breve, por ejemplo «Subida al 50 %». - No anuncie cada punto porcentual. Avise cada cierto tramo y al terminar, para no saturar a la persona.
- No mueva el foco a la barra ni al mensaje. La persona debe poder seguir donde estaba.
- Como el soporte aún es limitado, compruebe antes que la función existe. Mantenga además una región viva con
role="status"(técnica ARIA25) como vía principal.
Cómo comprobarlo
- Localice en la página una barra de progreso que cambie sola, por ejemplo al subir un archivo.
- Active un lector de pantalla compatible y lance la acción.
- Compruebe que oye el avance y el final sin que el foco se mueva.
- Pruebe también en un navegador sin
ariaNotify. La región viva debe seguir anunciando el estado.
Ejemplo
Aviso del avance de una subida, usando ariaNotify solo si el navegador lo admite.
function avisar(texto) {
// Vía principal: región viva con role="status"
document.getElementById("estado").textContent = texto;
// Mejora añadida si el navegador la admite
if ("ariaNotify" in document) {
document.ariaNotify(texto);
}
}
avisar("Subida al 50 %");
Ver el texto completo del W3C (traducción al español)
Esta es una traducción no oficial al español de la técnica ARIA27 de Techniques for WCAG 2.2, del W3C. Puede contener errores. El único documento oficial y normativo es la versión original en inglés, publicada en el sitio web del W3C.
Descripción
Esta técnica muestra cómo usar el método ariaNotify para transmitir por software a las tecnologías de asistencia el estado de una barra de progreso de subida de archivos.
A fecha de abril de 2026, ariaNotify sigue siendo una característica experimental en los navegadores web y las tecnologías de asistencia.
Hasta que tenga una compatibilidad más amplia, use ariaNotify únicamente como mejora progresiva en combinación con otras técnicas más fiables, como ARIA25: Usar una región activa de ARIA para transmitir el estado de una barra de progreso.
Ejemplo
Este ejemplo simula el progreso de la subida de un documento. El progreso de la subida se comunica visualmente al usuario con una barra de progreso. A medida que la barra de progreso se actualiza, también se pasa explícitamente un texto al método ariaNotify para provocar un anuncio por parte de los lectores de pantalla.
El siguiente código también puede verse como un ejemplo funcional.
<div class="upload-container">
<p id="upload-progress-label">Uploading document: <strong>report.pdf</strong></p>
<div
aria-labelledby="upload-progress-label"
role="progressbar"
aria-describedby="progress-text"
aria-valuemin="0"
aria-valuemax="100"
aria-valuenow="0"
id="upload-progress"></div>
<button id="start-upload" type="button">Start Upload</button>
document.ariaNotify("…");
Pruebas
Procedimiento
- Verificar si la página contiene una barra de progreso que cambia dinámicamente para transmitir visualmente información de estado al usuario.
- Con un lector de pantalla, comprobar que las actualizaciones de la barra de progreso se transmiten al usuario sin que el foco se mueva por software a la barra de progreso o al mensaje de estado
Resultados esperados
- Las comprobaciones n.º 1 y n.º 2 son verdaderas.
Cómo lo comprobamos en ADDAW
En cada auditoría de ADDAW revisamos esta técnica página a página y le entregamos los errores con capturas y la forma de corregirlos.
Basado en la técnica ARIA27 del W3C (WCAG 2.2). Explicación y ejemplos: ADDAW. Traducción no oficial del texto del W3C © W3C, licencia de documentos del W3C. ¿Ha visto un error? Escríbanos.