Teknika Bezero-scriptak WCAG 2.2
SCR28Orri guztietan errepikatzen diren menuak tolesteko aukera ematea
Izen ofiziala W3Cn: Menu zabalgarri eta tolesgarri bat erabiltzea eduki-blokeak saltatzeko
Laburbilduz
Orri guztietan errepikatzen diren menu luzeek botoi bat izan dezakete tolesteko eta zabaltzeko. Tolestean, haien estekek fokua jasotzeari uzten diote, eta pantaila-irakurgailuak ez ditu irakurtzen. Horrela, pertsonak bloke hori saltatzen du eta lehenago iristen da eduki nagusira.
Zergatik da garrantzitsua
Teklatuarekin nabigatzen duenak Tab sakatu behar du menuko esteka bakoitzean edukira iritsi aurretik. 40 estekako menu batean, hori bisitatzen duen orri guztietan gertatzen zaio.
Pantaila-irakurgailuak (pantailan dagoena ozen irakurtzen duen programa) ere menu bera irakurtzen du behin eta berriz. Menu tolesgarri bati esker, sakatze bakar batekin salta daiteke.
Nola egiten da
- Jarri botoi bat (
<button>) bloke errepikatuaren justu aurretik, testu argi batekin, «Gidaren aurkibidea», adibidez. - Adierazi haren egoera
aria-expanded="true"edo"false"erabiliz. Lotu botoia blokearekinaria-controlsbidez. - Tolestean, ezkutatu blokea benetan,
hiddenatributuarekin edodisplay: noneerabiliz. Horrela, haren estekek ez dute fokua jasotzen eta ez dira irakurtzen. - Zabaltzean, edukiak botoiaren justu ondoren agertu behar du, irakurketa-ordena logiko batean.
- Aztertu pertsonaren hobespena orri batetik bestera gogoratzea komeni den,
localStorageerabiliz, adibidez. - Teknika hau «Joan eduki nagusira» esteka batekin konbina daiteke.
Nola egiaztatu
- Bilatu bloke errepikatua tolestu eta zabaltzen duen kontrola. Tab teklarekin iritsi behar da hara, eta Sartu teklarekin edo Zuriune-barrarekin aktibatu.
- Tolestu blokea eta sakatu Tab. Fokuak ez du haren esteketako batetik ere igaro behar.
- Pantaila-irakurgailu batekin, egiaztatu tolestutako blokea ez dela irakurtzen eta botoia «tolestuta» gisa iragartzen dela.
- Zabaldu blokea eta egiaztatu haren estekak botoiaren justu ondoren agertzen direla.
Adibidea
Orri guztietan errepikatzen den eta botoi batekin tolesten den gida baten aurkibidea.
<button type="button" aria-expanded="true" aria-controls="indice">
Gidaren aurkibidea
</button>
<ul id="indice">
<li><a href="/guia/requisitos">Betekizunak</a></li>
<li><a href="/guia/plazos">Epeak</a></li>
</ul>
<script>
var boton = document.querySelector('[aria-controls="indice"]');
boton.addEventListener('click', function () {
var abierto = boton.getAttribute('aria-expanded') === 'true';
boton.setAttribute('aria-expanded', String(!abierto));
document.getElementById('indice').hidden = abierto;
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR28 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Bezeroaren aldeko scriptak eskaintzen dituzten teknologiak.
Deskribapena
Teknika honi esker, erabiltzaileek errepikatutako materiala salta dezakete, erabiltzaileak berak kontrolatuta zabaldu edo tolestu daitekeen menu batean jarrita. Erabiltzaileak errepikatutako materiala salta dezake menua tolestuta. Erabiltzaileak erabiltzaile-interfazeko kontrol bat erabiltzen du menuko elementuak ezkutatzeko edo kentzeko. Baliabideen atalean menuetarako, tresna-barretarako eta zuhaitzetarako hainbat teknika zerrendatzen dira, eta horietako edozein erabil daiteke nabigazioa saltatzeko mekanismo bat emateko.
Antzeko ikuspegiak inplementa daitezke zerbitzariaren aldeko scriptak erabiliz eta web-orriaren bertsio aldatu bat berriro kargatuz.
Adibideak
Eduki-aurkibide bat erakustea eta ezkutatzea
Web-orri multzo baten eduki-aurkibidea web-orri bakoitzaren hasieratik gertu errepikatzen da. Aurkibidearen hasieran dagoen botoi bati esker, erabiltzaileak aurkibidea orritik ken dezake edo berriro jar dezake.
...
<script>
let tocToggle = document.querySelector(".toc-toggle");
let toc = document.querySelector("#toc");
tocToggle.addEventListener("click", toggle, false);
function toggle(e){
let elm = e.currentTarget;
if(elm.getAttribute("aria-expanded") === "false"){
elm.setAttribute("aria-expanded", "true");
}
else{
elm.setAttribute("aria-expanded", "false");
}
}
</script>
...
<button aria-controls="toc" aria-expanded="true" class="toc-toggle" type="button">
Toggle Table Of Contents
</button>
<nav aria-labelledby="toc-header" id="toc">
<h2 id="toc-header">Table of Contents</h2>
<ul>
<li><a href="#sec1">Section 1</a></li>
<li><a href="#sec2">Section 2</a></li>
<li><a href="#sec3">Section 3</a></li>
<li><a href="#sec4">Section 4</a></li>
</ul>
</nav>
...
Kode honen adibide praktikoa: Eduki-aurkibide bat botoi batekin erakustea eta ezkutatzea.
Probak
Prozedura
- Egiaztatzea erabiltzaile-interfazeko kontrolen batek errepikatutako edukia zabaltzeko edo tolesteko aukera ematen duela.
- Egiaztatzea, edukia zabalduta dagoenean, programatikoki zehaztu daitekeen edukian sartzen dela, irakurketa-ordenako leku logiko batean.
- Egiaztatzea, edukia tolestuta dagoenean, ez dela programatikoki zehaztu daitekeen edukiaren parte.
Espero diren emaitzak
- Aurreko egiaztapen guztiak egiazkoak dira.
Baliabideak
- ARIA - Disclosure (Show/Hide) pattern. (ARIAren egiletza-praktiketako Disclosure eredua, erakutsi/ezkutatu)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR28 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.