Addaw, anar a la pàgina d'inici Donar

Tècnica ARIA WCAG 2.2

ARIA27Anunciar l'avanç d'una barra de progrés amb ariaNotify

Nom oficial al W3C: Utilitzar ariaNotify per transmetre l'estat d'una barra de progrés

Versión en castellano

En poques paraules

ariaNotify és una funció nova de JavaScript que demana al lector de pantalla que llegeixi un missatge en veu alta. Serveix per avisar de l'avanç d'una pujada de fitxers sense moure el focus. Encara és experimental, així que s'ha d'utilitzar com a millora afegida a una regió activa.

Per què és important

Una barra de progrés sol canviar només de manera visual. Una persona cega que puja un document no sap si la pujada avança, s'ha aturat o ha acabat.

Si l'avís arriba al lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla), la persona pot continuar treballant i assabentar-se del resultat. Això és el que demana el criteri de missatges d'estat.

Com es fa

  1. Tingueu una barra de progrés visible i amb nom, per exemple amb <progress> i la seva etiqueta.
  2. Quan l'avanç canviï de manera important, crideu ariaNotify() amb un text breu, per exemple «Pujada al 50 %».
  3. No anuncieu cada punt percentual. Aviseu cada cert tram i en acabar, per no saturar la persona.
  4. No moveu el focus a la barra ni al missatge. La persona ha de poder continuar on era.
  5. Com que la compatibilitat encara és limitada, comproveu abans que la funció existeix. Mantingueu, a més, una regió activa amb role="status" (tècnica ARIA25) com a via principal.

Com comprovar-ho

  1. Localitzeu a la pàgina una barra de progrés que canviï sola, per exemple en pujar un fitxer.
  2. Activeu un lector de pantalla compatible i inicieu l'acció.
  3. Comproveu que sentiu l'avanç i el final sense que el focus es mogui.
  4. Proveu-ho també en un navegador sense ariaNotify. La regió activa ha de continuar anunciant l'estat.

Exemple

Avís de l'avanç d'una pujada, utilitzant ariaNotify només si el navegador l'admet.

function avisar(texto) {
  // Via principal: regió activa amb role="status"
  document.getElementById("estado").textContent = texto;
  // Millora afegida si el navegador l'admet
  if ("ariaNotify" in document) {
    document.ariaNotify(texto);
  }
}
avisar("Pujada al 50 %");
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA27 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Descripció

Aquesta tècnica mostra com utilitzar el mètode ariaNotify per transmetre per programari a les tecnologies de suport l'estat d'una barra de progrés de pujada de fitxers.

A data d'abril de 2026, ariaNotify continua sent una característica experimental en els navegadors web i les tecnologies de suport.

Fins que tingui una compatibilitat més àmplia, utilitzeu ariaNotify únicament com a millora progressiva en combinació amb altres tècniques més fiables, com ara ARIA25: Utilitzar una regió activa d'ARIA per transmetre l'estat d'una barra de progrés.

Exemple

Aquest exemple simula el progrés de la pujada d'un document. El progrés de la pujada es comunica visualment a l'usuari amb una barra de progrés. A mesura que la barra de progrés s'actualitza, també es passa explícitament un text al mètode ariaNotify per provocar un anunci per part dels lectors de pantalla.

El codi següent també es pot veure com a exemple 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("…");

Proves

Procediment

  1. Verificar si la pàgina conté una barra de progrés que canvia dinàmicament per transmetre visualment informació d'estat a l'usuari.
  2. Amb un lector de pantalla, comprovar que les actualitzacions de la barra de progrés es transmeten a l'usuari sense que el focus es mogui per programari a la barra de progrés o al missatge d'estat

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes.

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica ARIA27 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.