Técnica ARIA WCAG 2.2

ARIA27Usar ariaNotify para transmitir el estado de una barra de progreso

En resumen

El método ariaNotify permite que una página pida directamente al lector de pantalla que anuncie un mensaje, sin necesidad de insertar texto en una región activa. Esta técnica lo usa para comunicar el avance de una barra de progreso de subida de archivos. Como todavía es una función experimental, úsela solo como mejora progresiva junto con técnicas más fiables, como ARIA25.

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 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.

Solicitar una auditoría

Fuente y licencia

Traducción al español, no oficial, realizada por ADDAW a partir de la técnica ARIA27 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.