Teknika Bezero-scriptak WCAG 2.2
SCR27Orriko blokeak menuko aukerekin berrantolatzea, ez arrastatuz soilik
Izen ofiziala W3Cn: Orriko atalak Document Object Model bidez berrantolatzea
Laburbilduz
Orri batek blokeen ordena saguarekin arrastatuz aldatzeko aukera ematen badu, «Igo» eta «Jaitsi» bezalako aukerak ere eskaini behar ditu bloke bakoitzean. Aukera horiek teklatuarekin funtzionatzen dute. Gainera, scriptak kodeko benetako ordena aldatu behar du, ez pantailako kokapena soilik.
Zergatik da garrantzitsua
Arrastatu eta jaregiteko, sagua edo hatza ondo kontrolatu behar dira. Teklatua soilik, pantaila-irakurgailua edo sakagailu bat erabiltzen duenak ezin du arrastatu.
Adibidez, «Agenda», «Albisteak» eta «Oharrak» moduluak dituen intranet batean, pertsona horiek ezingo lukete beren panela pertsonalizatu. Eta aldaketa bisuala soilik bada, irakurketa- eta tabulazio-ordena jada ez dator bat ikusten denarekin.
Nola egiten da
- Gehitu mugi daitekeen bloke bakoitzari menu txiki bat, «Igo» eta «Jaitsi» bezalako aukerekin. Saretak zutabeak baditu, gehitu «Ezkerrera» eta «Eskuinera» ere.
- Erabili botoiak edo estekak aukera horietarako, eta abiarazi scripta
clickgertaeratik. - Jarri menu hori kodean blokearen beraren barruan, mugitzen duenaren ondoan.
- Mugitu blokea DOMean (nabigatzaileak HTMLtik abiatuta sortzen duen orriaren egitura),
insertBeforeerabiliz, adibidez. Ez kokatu berriro CSS bidez soilik. - Mugitu ondoren, itzuli fokua sakatutako aukerara. Horrela, pertsonak mugitzen jarrai dezake galdu gabe.
- Eman aukera bakoitzari izen argi bat, «Igo Albisteak blokea», adibidez.
Nola egiaztatu
- Aurkitu arrasta daitezkeen blokeak.
- Egiaztatu bakoitzak mugitzeko aukerak dituela, Tab teklarekin iristen direnak eta Sartu teklarekin aktibatzen direnak.
- Mugitu bloke bat teklatuarekin. Fokuak erabilitako aukeran jarraitu behar du.
- Ibili orrian zehar Tab teklarekin edo pantaila-irakurgailuarekin. Ordenak pantailako ordena berriarekin bat etorri behar du.
- Nabigatzailearen tresnetan (F12), egiaztatu blokea kodean lekuz aldatu dela.
Adibidea
Zerrenda bateko modulu bakoitzak «Igo» botoi bat du, eta botoi horrek benetan mugitzen du modulua kodean.
<li class="modulo">
<h2>Albisteak</h2>
<button type="button" class="subir">Igo Albisteak blokea</button>
</li>
<script>
document.querySelectorAll('.subir').forEach(function (boton) {
boton.addEventListener('click', function () {
var modulo = boton.closest('.modulo');
var anterior = modulo.previousElementSibling;
if (anterior) modulo.parentNode.insertBefore(modulo, anterior);
boton.focus(); // fokuak sakatutako botoian jarraitzen du
});
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR27 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTML, scriptak
Deskribapena
Teknika honen helburua da osagaiak berrantolatzeko mekanismo bat ematea, oso erabilgarria eta, aldi berean, irisgarria. Berrantolatzeko bi mekanismo ohikoenak hauek dira: erabiltzaileak konfigurazio-orri batera bidaltzea, osagaiak zenbakitu ditzaten, edo osagaiak nahi duten lekura arrastatu eta jaregiten uztea. Arrastatu eta jaregitea askoz erabilgarriagoa da, erabiltzaileari elementuak beren lekuan, banan-banan, kokatzeko eta emaitzaren ideia bat egiteko aukera ematen diolako. Zoritxarrez, arrastatu eta jaregitea saguaren erabileraren mende dago. Teknika honi esker, erabiltzaileek osagaietan kokatutako menu batekin elkarreragin dezakete, osagaiak beren lekuan berrantolatzeko, gailuarekiko modu independentean. Arrastatu eta jaregite bidezko berrantolatze-funtzionaltasunaren ordez edo harekin batera erabil daiteke.
Menua esteka-zerrenda bat da, eta gailuarekiko independentea den onclick gertaera erabiltzen du edukia berrantolatzen duten scriptak abiarazteko. Edukia Document Object Modelean (DOM) berrantolatzen da, ez bisualki soilik, gailu guztietarako ordena zuzenean egon dadin.
Adibideak
Adibide honek gora eta behera berrantolatzen du. Ikuspegi hau bi dimentsioko berrantolaketa baterako ere erabil daiteke, ezkerrera eta eskuinera aukerak gehituta.
Adibide honetako osagaiak ordenatu gabeko zerrenda bateko elementuak dira. Ordenatu gabeko zerrendak oso eredu semantiko egokia dira antzeko elementu-multzoetarako, osagai hauetarako, adibidez. Menuaren ikuspegia beste taldekatze mota batzuetarako ere erabil daiteke.
Moduluak zerrendako elementuak dira, eta modulu bakoitzak, div elementuetako edukiaz gain, menu bat dauka, habiaratutako zerrenda gisa adierazita.
<ul id="swapper">
<li id="black">
<div class="module">
<div class="module_header">
<!-- menu link -->
<a href="#" onclick="ToggleMenu(event);">menu</a>
<!-- menu -->
<ul class="menu">
<li><a href="#" onclick="OnMenuClick(event)"
onkeypress="OnMenuKeypress(event);">up</a></li>
<li><a href="#" onclick="OnMenuClick(event)"
onkeypress="OnMenuKeypress(event);">down</a></li>
</ul>
</div>
<div class="module_body">
Text in the black module
</div>
</div>
</li>
...
</ul>
Zuhaitz sinplearen adibideetan menuak nola erakutsi eta ezkutatu landu dugunez, hemen moduluak trukatzen dituen kodean bakarrik jarriko dugu arreta. Gertaerak bateratu eta estekaren ekintza lehenetsia bertan behera utzi ondoren, lanean hasiko gara. Lehenik, aldagai lokal batzuk definituko ditugu landuko ditugun elementuetarako: menua, berrantolatuko den modulua eta menuaren esteka (menuLink). Ondoren, berrantolaketaren norabidea egiaztatu eta gero, trukatzeko nodoa lortzen saiatuko gara. Aurkitzen badugu, swapNode() deituko dugu gure bi moduluak trukatzeko eta PositionElement() modu absolutuan kokatutako menua moduluarekin batera mugitzeko, eta, jarraian, dena abian jarri zuen menuko elementura itzuliko dugu fokua.
function MoveNode(evt,dir){
HarmonizeEvent(evt);
evt.preventDefault();
var src = evt.target;
var menu = src.parentNode.parentNode;
var module = menu.parentNode.parentNode.parentNode;
var menuLink = module.getElementsByTagName("a")[0];
var swap = null;
switch(dir){
case 'up': {
swap = module.previousSibling;
while (swap && swap.nodeType != 1){
swap = swap.previousSibling;
}
break;
}
case 'down': {
swap = module.nextSibling;
while (swap && swap.nodeType != 1){
swap = swap.nextSibling;
}
break;
}
}
if (swap && swap.tagName == node.tagName){
module.swapNode(swap);
PositionElement(menu,menuLink,false,true);
}
src.focus();
}
Nodoak trukatzeko CSSa ez da asko bereizten zuhaitzaren aurreko adibideetakotik; tamaina- eta kolore-doikuntza batzuk baino ez ditu moduluetarako eta menu txikirako.
ul#swapper {
list-item-style:none;
margin:0px;
padding:0px;
}
ul#swapper li {
border:1px solid black;
height:5em;
list-style:none;
margin:1em;
padding:0;
width:15em;
}
ul#swapper li a {
color:white;
font-size:90%;
text-decoration:none;
}
ul#swapper li div.module_header {
padding:0 0.2em;
text-align:right;
}
ul#swapper li div.module_body {
padding:0.2em;
}
ul#swapper ul.menu {
background-color:#eeeeee;
border:1px solid gray;
display:none;
height:auto;
list-style:none;
margin:0;
padding:0;
position:absolute;
text-align:left;
}
ul#swapper ul.menu li {
border:none;
font-weight:normal;
height:auto;
margin:0;
text-align:left;
width:5em;
}
ul#swapper ul.menu li a {
color:black;
display:block;
padding:0 0.1em;
text-decoration:none;
width:100%;
}
Probak
Prozedura
- Arrastatu eta jaregitearen bidez berrantola daitezkeen osagai guztiak aurkitzea.
- Egiaztatzea badagoela, halaber, osagaiak esteka-zerrendekin eraikitako menuen bidez berrantolatzeko mekanismo bat.
- Egiaztatzea menuak DOMeko elementu berrantolagarrien barruan daudela.
- Egiaztatzea berrantolatzeko scriptak esteken onclick gertaeratik soilik abiarazten direla.
- Egiaztatzea elementuak DOMean berrantolatzen direla, ez bisualki soilik.
Espero diren emaitzak
- 2. egiaztapenetik 5.era bitartekoak 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 SCR27 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.