Teknika Bezero-scriptak WCAG 2.2
SCR26Eduki berria irekitzen duen kontrolaren justu ondoren txertatzea
Izen ofiziala W3Cn: Eduki dinamikoa Document Object Modelean txertatzea, hura aktibatzen duen elementuaren berehala ondoren
Laburbilduz
Botoi edo esteka batek eduki berria erakusten duenean JavaScript bidez, azpimenu bat edo panel bat, adibidez, eduki horrek kodean kontrolaren justu atzean egon behar du. Horrela, Tab sakatzean edo pantaila-irakurgailuarekin irakurtzen jarraitzean, aurkitzen den hurrengo gauza oraintxe agertu dena da, hain zuzen.
Zergatik da garrantzitsua
Teklatuarekin nabigatzen duenak Tab teklarekin egiten du aurrera, HTML kodearen ordenari jarraituz. Pantaila-irakurgailuak (pantailan dagoena ozen irakurtzen duen programa) ere ordena horretan irakurtzen du.
Scriptak azpimenua orriaren amaieran gehitzen badu, pertsonak «Zerbitzuak» sakatzen du eta ez du ezer aurkitzen jarraian. Orri osoa igaro beharko luke aukera berrietara iristeko. Pantailan ondo kokatuta dagoela dirudi, baina kodean urrun dago.
Nola egiten da
- Erabili
<button>bat edo esteka bat edukia irekitzen duen kontrol gisa. Biek jasotzen dute fokua eta teklatuari erantzuten diote. - Abiarazi scripta
clickgertaeratik. Gertaera horrek saguarekin funtzionatzen du, baita teklatuarekin ere. - Txertatu eduki berria DOMean (nabigatzaileak HTMLtik abiatuta sortzen duen orriaren egitura) kontrolaren justu ondoren. Adibidez,
control.after(panel)erabiliz. - Utzi fokua kontrolean. Tab teklaren hurrengo sakatzeak eduki berriko lehen elementura eramango du.
- Pantailan beste kokapen bat behar baduzu, mugitu CSS bidez. Ez aldatu haren lekua kodean.
- Edukia geroago iristen bada zerbitzaritik, abisatu pantaila-irakurgailuari ere,
aria-liveeskualde batekin, adibidez.
Nola egiaztatu
- Ireki menu edo panel zabalgarri bakoitza teklatuarekin: iritsi kontrolera Tab teklarekin eta sakatu Sartu.
- Sakatu Tab beste behin. Fokuak oraintxe agertu den edukiaren lehen elementura joan behar du.
- Ireki nabigatzailearen tresnak (F12), «Elementuak» fitxa. Egiaztatu eduki berria kontrolaren justu ondoren dagoela.
- Pantaila-irakurgailu batekin, jarraitu irakurtzen kontrolaren ondoren. Eduki berria entzun behar duzu jarraian.
Adibidea
«Zerbitzuak» botoi batek bere azpimenua sortzen du, eta kodean bere justu atzean jartzen du.
<button type="button" id="servicios" aria-expanded="false">Zerbitzuak</button>
<script>
var boton = document.getElementById('servicios');
boton.addEventListener('click', function () {
var menu = document.createElement('ul');
menu.innerHTML = '<li><a href="/padron">Errolda</a></li>' +
'<li><a href="/tasas">Tasak eta ordainketak</a></li>';
boton.after(menu); // botoiaren justu atzean
boton.setAttribute('aria-expanded', 'true');
}, { once: true });
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR26 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTML eta scriptak
Deskribapena
Teknika honen helburua da Document Object Modelean (DOM) txertatutako erabiltzaile-interfazeko elementuak kokatzea, tabulazio-ordena eta pantaila-irakurgailuaren irakurketa-ordena erabiltzaile-agentearen lehenetsitako portaerak behar bezala ezar ditzan. Teknika hau ezkutatu eta erakusten den erabiltzaile-interfazeko edozein elementutarako erabil daiteke, menuetarako eta elkarrizketa-koadroetarako, adibidez.
Pantaila-irakurgailu bateko irakurketa-ordena HTML elementuek Document Object Modelean duten ordenan oinarritzen da, lehenetsitako tabulazio-ordena bezala. Teknika honek eduki berria DOMean txertatzen du scripta abiarazteko aktibatu den elementuaren berehala ondoren. Elementu abiarazleak esteka edo botoi bat izan behar du, eta scriptari haren onclick gertaeratik deitu behar zaio. Elementu horiek modu natiboan jaso dezakete fokua, eta haien onclick gertaera gailuaren mende ez dago. Fokua aktibatutako elementuan geratzen da, eta jarraian txertatutako eduki berria hurrengoa bihurtzen da, bai tabulazio-ordenan, bai pantaila-irakurgailuaren irakurketa-ordenan.
Kontuan izan teknika honek eguneratze sinkronoetarako funtzionatzen duela. Eguneratze asinkronoetarako (batzuetan AJAX deituak), teknika gehigarri bat behar da, laguntza-teknologiari eduki asinkronoa txertatu dela jakinarazteko.
Adibideak
Adibide honek menu bat sortzen du esteka batean klik egiten denean, eta estekaren ondoren txertatzen du. Estekaren onclick gertaera ShowHide scriptari deitzeko erabiltzen da, eta menu berrirako id bat pasatzen zaio parametro gisa.
<button aria-expanded="false" type="button" onclick="ShowHide('foo',this)">
Toggle
</button>
ShowHide scriptak menu berria duen div bat sortzen du, eta esteka bat txertatzen du haren barruan. Azken lerroa da scriptaren muina. Scripta abiarazi duen elementuaren elementu gurasoa aurkitzen du, eta sortu duen div-a seme-alaba berri gisa gehitzen dio. Horren ondorioz, div berria DOMean menuaren ondoren geratzen da. Erabiltzaileak tabulazio-tekla sakatzen duenean, fokua jaso dezakeen menuko lehen elementura igaroko da: sortu dugun estekara.
function ShowHide(id,src){
var el = document.getElementById(id);
if (!el){
el = document.createElement("div");
el.id = id;
var link = document.createElement("a");
link.href = "/laptops";
link.appendChild(document.createTextNode("Laptops"));
el.appendChild(link);
src.parentElement.appendChild(el);
src.setAttribute("aria-controls", id);
src.setAttribute("aria-expanded", "true");
}
else if (el && src.getAttribute("aria-expanded") === "false"){
el.style.display = 'block';
src.setAttribute("aria-expanded", "true");
}
else{
el.style.display = 'none';
src.setAttribute("aria-expanded", "false");
}
}
CSS erabiltzen da div-ari eta estekari menu baten itxura emateko.
Probak
Prozedura
- Aurkitu leiho gainerakor ez diren elkarrizketa-koadroak irekitzen dituzten orriko gune guztiak.
- Egiaztatu elkarrizketa-koadroak botoi baten edo esteka baten click gertaeratik aktibatzen direla.
- Scriptak sortutako DOMa ikuskatzeko aukera ematen duen tresna batekin, egiaztatu elkarrizketa-koadroa DOMeko hurrengo elementua dela.
Espero diren emaitzak
- 2. eta 3. 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.
W3Cren SCR26 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.