Addaw, joan hasierara Egin dohaintza

Teknika Bezero-scriptak WCAG 2.2

SCR14Pertsonari larriak ez diren abisuak aktibatzen edo desaktibatzen uztea

Izen ofiziala W3Cn: Scriptak erabiltzea funtsezkoak ez diren alertak aukerakoak izan daitezen

Versión en castellano · Versió en català

Laburbilduz

Orri batzuek datuak eguneratzen dituzte segundo gutxi batzuetik behin, eta pantaila-irakurgailuak guztiak iragartzen ditu. Teknika honek botoiak gehitzen ditu abisu horiek aktibatzeko edo desaktibatzeko. JavaScript bidez, eguneratzen den eremuaren aria-live balioa aldatzen da.

Zergatik da garrantzitsua

Pantaila-irakurgailu batek (pantailan dagoena ozenki irakurtzen duen programa) irakurtzen ari dena eteten du eskualde bizi bateko aldaketa bakoitza iragartzeko.

Kotizazio bat, kirol-markagailu bat edo txat bat etengabe eguneratzen bada, pertsonak ezin du orriaren gainerakoa irakurri. Arreta-arazoak dituzten pertsonak ere gogaitzen ditu. Larriak ez diren abisuak atzeratu edo desaktibatu ahal izan behar dira.

Nola egiten da

  1. Markatu eguneratzen den eremua eskualde bizi gisa aria-live bidez. Eskualde bizia pantaila-irakurgailuak fokua mugitu gabe aldaketak irakurtzen dizkion eremua da.
  2. Gehitu kontrol ikusgarri bat eremu horren ondoan, «Desaktibatu abisuak» botoia, adibidez.
  3. Sakatzean, aldatu aria-live off baliora. Berriro aktibatzean, itzuli polite edo assertive baliora.
  4. Adierazi botoiaren egoera aria-pressed bidez edo haren testua aldatuz.
  5. Gogoratu hobespena (adibidez, cookie batekin) hurrengo bisitetarako.
  6. Ez utzi larrialdi-abisuak desaktibatzen, segurtasun-alerta bat, adibidez.

Nola egiaztatu

  1. Kargatu orria eta aurkitu berez eguneratzen diren eremuak.
  2. Egiaztatu badagoela haien abisuak aktibatzeko eta desaktibatzeko kontrol bat, eta teklatuarekin funtzionatzen duela.
  3. Pantaila-irakurgailu batekin, desaktibatu abisuak eta egiaztatu irakurtzeari uzten diotela.
  4. Aktibatu berriro eta egiaztatu berriro iragartzen direla.

Adibidea

Kotizazio baten iragarpenak aktibatzen edo desaktibatzen dituen botoia.

<div id="cotizacion" aria-live="polite">IBEX 35: 11.250</div>
<button id="avisos" aria-pressed="true">Aldaketen abisuak</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>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko SCR14 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

Larrialdikoak ez diren komunikazioetarako script-alertak erabiltzen dituzten script-teknologiak.

Deskribapena

Teknika honen helburua da pantaila-irakurgailuek burtsa-kotizazioen alerta-osagai bateko aldaketez egiten dituzten iragarpenak aktibatzeko eta desaktibatzeko aukera ematea. Lehenespenez, kotizazioa aldatzen denean, pantaila-irakurgailuek aldaketa iragartzen dute. Hori gogaikarria izan daiteke erabiltzaile batzuentzat; horregatik, iragarpenak aktibatzeko edo desaktibatzeko aukera ematen dieten botoiak daude.

Teknika honek aria-live propietatea erabiltzen du kotizazio-osagaia eskualde bizi (live region) bihurtzeko, eta aria-atomic propietatea pantaila-irakurgailuei adierazteko osagaiaren eduki osoa iragartzeko kotizazioa eguneratzen denean, eta ez eguneratutakoa bakarrik. Erakustaldi honen ondorioetarako, kotizazioa 10 segundotik behin eguneratzen da. Iragarpenak aktibatuta badaude, aria-live propietateari assertive balioa ematen zaio; iragarpenak desaktibatuta badaude, aria-live propietateari off balioa ematen zaio. Iragarpenak kontrolatzen dituzten bi botoiek aria-pressed propietatea erabiltzen dute, true edo false baliora eguneratuta, pantaila-irakurgailuak erabiltzen dituztenei jakinarazteko zein botoi dagoen sakatuta eta, beraz, haien pantaila-irakurgailuak kotizazioaren eguneratzeak iragarriko dituen ala ez. Benetako egoera batean, egileak cookie bat (edo baliokide bat) gordetzea pentsatu beharko luke erabiltzailearen hobespena biltegiratzeko, orrira egiten dituen hurrengo bisitetan gorde dadin.

Adibideak

Pantaila-irakurgailuaren konfigurazioa eguneratzea kotizazioen eguneratze-alertetarako

Hurrengo scriptak burtsa-balio bat eguneratuko du aria-live osagai baten barruan 10 segundotik behin. Erabiltzaileak "Turn Announcements Off" botoia (desaktibatu iragarpenak) sakatzen badu, haren pantaila-irakurgailuak iragarpenak egiteari utziko dio burtsa-balioa aldatzen denean; "Turn Announcements On" botoia (aktibatu iragarpenak) sakatzen badu, iragarpenak berriro hasiko dira.

JavaScripta

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

HTMLa

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

Kode honen adibide funtzionala: ARIA alertak aktibatzeko eta desaktibatzeko erakustaldia.

Probak

Prozedura

Larrialdikoak ez diren etenaldiak onartzen dituen web-orri baterako:

  1. Kargatu web-orria eta egiaztatu ez dela larrialdikoa ez den alertarik erakusten.
  2. Egiaztatu badagoela larrialdikoak ez diren etenaldiak aktibatzeko eta desaktibatzeko mekanismo bat.

Espero diren emaitzak

  • Larrialdikoak ez diren etenaldiak onartzen dituen web-orri baterako, 1. eta 2. egiaztapenak egiazkoak dira.

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

W3Cren SCR14 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.