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

Tècnica Scripts de client WCAG 2.2

SCR14Deixar que la persona activi o desactivi els avisos que no són urgents

Nom oficial al W3C: Utilitzar scripts per fer opcionals les alertes no essencials

Versión en castellano

En poques paraules

Algunes pàgines actualitzen dades cada pocs segons i el lector de pantalla les anuncia totes. Aquesta tècnica afegeix botons per activar o desactivar aquests avisos. Amb JavaScript es canvia el valor d'aria-live de la zona que s'actualitza.

Per què és important

Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) interromp el que està llegint per anunciar cada canvi d'una regió activa.

Si una cotització, un marcador esportiu o un xat s'actualitza sense parar, la persona no pot llegir la resta de la pàgina. També molesta persones amb problemes d'atenció. Els avisos no urgents s'han de poder ajornar o desactivar.

Com es fa

  1. Marqueu la zona que s'actualitza com a regió activa amb aria-live. Una regió activa és una zona els canvis de la qual llegeix el lector de pantalla sense moure el focus.
  2. Afegiu un control visible, per exemple un botó «Desactiva els avisos», a prop d'aquesta zona.
  3. En prémer-lo, canvieu aria-live a off. En reactivar-lo, torneu a polite o assertive.
  4. Indiqueu l'estat del botó amb aria-pressed o canviant-ne el text.
  5. Recordeu la preferència (per exemple, amb una galeta) per a les visites següents.
  6. No permeteu desactivar els avisos d'emergència, com ara una alerta de seguretat.

Com comprovar-ho

  1. Carregueu la pàgina i localitzeu les zones que s'actualitzen soles.
  2. Comproveu que hi ha un control per activar i desactivar els seus avisos i que funciona amb el teclat.
  3. Amb un lector de pantalla, desactiveu els avisos i confirmeu que deixen de llegir-se.
  4. Activeu-los de nou i confirmeu que es tornen a anunciar.

Exemple

Botó que activa o desactiva els anuncis d'una cotització.

<div id="cotizacion" aria-live="polite">IBEX 35: 11.250</div>
<button id="avisos" aria-pressed="true">Avisos de canvis</button>
<script>
  const zona = document.getElementById("cotizacion");
  const boton = document.getElementById("avisos");
  boton.addEventListener("click", () => {
    const activos = boton.getAttribute("aria-pressed") === "true";
    boton.setAttribute("aria-pressed", String(!activos));
    zona.setAttribute("aria-live", activos ? "off" : "polite");
  });
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR14 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.

Aplicabilitat

Tecnologies d'scripts que utilitzen alertes d'script per a comunicacions que no són d'emergència.

Descripció

L'objectiu d'aquesta tècnica és permetre activar i desactivar els anuncis que fan els lectors de pantalla dels canvis en un component d'alerta de cotització borsària. De manera predeterminada, quan canvia la cotització, els lectors de pantalla anuncien el canvi. Això pot resultar molest per a alguns usuaris, així que hi ha botons que els permeten activar o desactivar els anuncis.

Aquesta tècnica utilitza la propietat aria-live per convertir el component de cotització en una regió activa (live region) i la propietat aria-atomic per indicar als lectors de pantalla que anunciïn tot el contingut del component, en lloc de només el que s'ha actualitzat, quan la cotització s'actualitza. A efectes d'aquesta demostració, la cotització s'actualitza cada 10 segons. Si els anuncis estan activats, la propietat aria-live s'estableix en assertive; si els anuncis estan desactivats, la propietat aria-live s'estableix en off. Els dos botons que controlen els anuncis utilitzen la propietat aria-pressed, actualitzada a true o a false, per informar qui utilitza lectors de pantalla de quin botó està premut i, per tant, de si el seu lector de pantalla anunciarà o no les actualitzacions de la cotització. En una situació real, l'autor s'hauria de plantejar desar una galeta (o equivalent) per emmagatzemar la preferència de l'usuari, de manera que es conservi en visites successives a la pàgina.

Exemples

Actualitzar la configuració del lector de pantalla per a les alertes d'actualització de cotitzacions

L'script següent actualitzarà un valor borsari dins d'un component aria-live cada 10 segons. Si l'usuari prem el botó "Turn Announcements Off" (desactiva els anuncis), el seu lector de pantalla deixarà de fer anuncis quan canviï el valor borsari; si prem el botó "Turn Announcements On" (activa els anuncis), els anuncis es reprendran.

El JavaScript

<script>
document.addEventListener("DOMContentLoaded", function (e) {
  const stockBox = document.querySelector("#stock-box");
  const stockMovement = document.querySelector("#stock-movement");
  const onBtn = document.querySelector("#live-on");
  const offBtn = document.querySelector("#live-off");
  const stocks = new Array("stock went down", "stock stayed the same", "stock went up");
  let loopCount = 0;
  onBtn.addEventListener("click", modifyLive, false);
  offBtn.addEventListener("click", modifyLive, false);
  function modifyLive(e){
    let elm = e.currentTarget;
    let liveState = elm.getAttribute("id");
    if (liveState === "live-off"){
      stockBox.setAttribute("aria-live", "off");
      onBtn.setAttribute("aria-pressed", "false");
      offBtn.setAttribute("aria-pressed", "true");
    }
    else{
      stockBox.setAttribute("aria-live", "assertive");
      onBtn.setAttribute("aria-pressed", "true");
      offBtn.setAttribute("aria-pressed", "false");
    }
  }
  setInterval(() => {
    if(loopCount >2){
      loopCount = 0;
    }
    stockMovement.innerHTML = stocks[loopCount];
      loopCount++;
    }, 10000)
  });
</script>

L'HTML

<body>
  <h1>Turbo Encabulator Stock Information</h1>
  <div id="stock-box" aria-atomic="true" aria-live="assertive">
    <span>Turbo Encabulator Stock Price: </span>
    <span id="stock-movement">stock went up</span>
  </div>
  <p>Use the buttons to toggle screen reader announcements of stock changes:</p>
  <div>
    <button aria-pressed="true" id="live-on" type="button">
     Turn Announcements On</button>
    <button aria-pressed="false" id="live-off" type="button">
     Turn Announcements Off</button>
  </div>
</body>

Exemple funcional d'aquest codi: Demostració d'activació i desactivació d'alertes ARIA.

Proves

Procediment

Per a una pàgina web que admet interrupcions que no són d'emergència:

  1. Carregar la pàgina web i verificar que no es mostra cap alerta que no sigui d'emergència.
  2. Verificar que hi ha un mecanisme per activar i desactivar les interrupcions que no són d'emergència.

Resultats esperats

  • Per a una pàgina web que admet interrupcions que no són d'emergència, 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 SCR14 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.