Teknika Bezero-scriptak WCAG 2.2
SCR35JavaScript-eko ekintzak botoiekin eta estekekin lotzea
Izen ofiziala W3Cn: Ekintzak teklatu bidez irisgarri egitea, esteken eta botoien onclick gertaera erabiliz
Laburbilduz
Script batek kontrol bat sakatzean zerbait egiten duenean, kontrol horrek benetako botoi edo esteka bat izan behar du. Elementu horiek fokua jasotzen dute, eta haien click gertaera teklatuarekin ere abiarazten da. Horrela, ekintzak berdin funtzionatzen du saguarekin, teklatuarekin eta pantaila-irakurgailuekin.
Zergatik da garrantzitsua
Web askok klik-gertaera div, span edo irudi batean jartzen dute. Saguarekin funtzionatzen du, baina elementu horiek ez dute fokua jasotzen, eta ez diete teklei erantzuten.
Teklatuarekin, pantaila-irakurgailu batekin (pantailan dagoena ozen irakurtzen duen programa) edo sakagailu batekin nabigatzen duenak ezin du ekintza aktibatu. Adibidez, ezingo luke bulego baten ordutegia ikusi, ezta produktu bat saskira gehitu ere.
Nola egiten da
- Ekintzak orrian zerbait aldatzen badu (erakutsi, ezkutatu, gehitu, kalkulatu), erabili
<button type="button">. - Beste leku batera eramaten badu, erabili
hrefduen<a>esteka bat.hrefgabe ez du fokua jasotzen. - Lotu scripta
clickgertaerarekin. Izenak sagua iradoki arren, teklatuarekin ere abiarazten da: estekak Sartu teklarekin, eta botoiak Sartu edo Zuriune-barrarekin. - Ez abiarazi ekintza saguarenak soilik diren gertaerekin, hala nola
mousedownedomouseover. - Orriak JavaScript gabe funtzionatu behar badu, eman alternatiba bat. Funtzio bera duen orri baterako
hrefbat izan daiteke, edo zerbitzarira bidaltzen den formulario bat. - Botoia irudi bat bada (
<input type="image">), jarri zer egiten duen esaten duenaltbat.
Adibide praktikoa
Udal-bulego baten fitxa, arreta-ordutegia erakusten edo ezkutatzen duen kontrol batekin. Ohikoa da hori klikari erantzuten dion div batekin egitea, botoi batekin egin beharrean.
Horrela ez: onclick duen eta botoiarena egiten duen div bat
Div elementuak saguaren klikari erantzuten dio. Baina ez du fokua jasotzen, eta ez dio erantzuten ez Sartu teklari ez Zuriune-barrari: teklatuarekin ez dago ordutegia ikusterik. Gainera, pantaila-irakurgailuak testu arrunt gisa irakurtzen du, ez kontrol gisa.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-akatsa.
Ikusi adibide okerraren kodea
<h2>Herritarrentzako Arreta Bulegoa</h2>
<div class="accion" onclick="verHorario(this)">Ikusi arreta-ordutegia</div>
<p id="horario" hidden>Astelehenetik ostiralera, 9:00etatik 14:00etara. Ostegunetan, baita 16:30etik 18:30era ere.</p>
<style>
h2 { font-size: 1.1em; }
.accion { display: inline-block; background: #744E9A; color: #fff; border: 0; padding: .5em 1em; font: inherit; cursor: pointer; }
</style>
<script>
function verHorario(control) {
var horario = document.getElementById('horario');
horario.hidden = !horario.hidden;
}
</script>Horrela bai: Ekintza bera, benetako botoi batean
Kontrola <button type="button"> bihurtzen da. Fokua jasotzen du, haren click gertaera Sartu teklarekin eta Zuriune-barrarekin ere abiarazten da, eta botoi gisa iragartzen da. Eduki bat ireki eta ixten duenez, aria-expanded du, irekita dagoen ala ez adierazten duena.
Probatu hemen:
Ikusi adibide zuzenaren kodea
<h2>Herritarrentzako Arreta Bulegoa</h2>
<button type="button" class="accion" aria-expanded="false" aria-controls="horario" onclick="verHorario(this)">Ikusi arreta-ordutegia</button>
<p id="horario" hidden>Astelehenetik ostiralera, 9:00etatik 14:00etara. Ostegunetan, baita 16:30etik 18:30era ere.</p>
<style>
h2 { font-size: 1.1em; }
.accion { display: inline-block; background: #744E9A; color: #fff; border: 0; padding: .5em 1em; font: inherit; cursor: pointer; }
.accion:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>
<script>
function verHorario(control) {
var horario = document.getElementById('horario');
horario.hidden = !horario.hidden;
control.setAttribute('aria-expanded', String(!horario.hidden));
}
</script>Nola egiaztatu
Auditorietako ohiko akatsak
- onclick duten div edo span elementuak botoi gisa erabiltzea: ez dute fokua jasotzen, eta ez diete erantzuten ez Sartu teklari ez Zuriune-barrari.
- Klik egiteko div bati tabindex="0" gehitzea, Sartu eta Zuriune-barra programatu gabe: fokua jasotzen du, baina ez du ezer egiten.
- href gabeko a esteka bat erabiltzea scriptak abiarazteko: href gabe ez du fokua jasotzen, eta ez da teklatuarekin aktibatzen.
- Ekintza mousedown edo mouseup bidez abiaraztea, click erabili beharrean: teklatuak ez ditu gertaera horiek abiarazten.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR35 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTML-rekin erabilitako scriptak.
Deskribapena
Teknika honen helburua da erakustea nola dei dakiokeen script-funtzio bati teklatu bidez irisgarria den moduan, teklatu bidez irisgarria den kontrol batekin lotuta. Scripten ekintzak teklatutik deitu ahal izango direla bermatzeko, «berez eragingarriak» diren HTML elementuekin (estekekin eta botoiekin) lotzen dira. Elementu horien onclick gertaera gailuarekiko independentea da. «onclick» saguari lotuta dagoela dirudien arren, egiaz onclick gertaera esteka edo botoi baten ekintza lehenetsiarekin lotuta dago. Ekintza lehenetsia gertatzen da erabiltzaileak elementuan saguarekin klik egiten duenean, baina baita erabiltzaileak fokua elementuan jarri eta Sartu edo Zuriune-barra sakatzen duenean ere, eta elementua irisgarritasun-APIaren bidez aktibatzen denean ere.
Teknika hau bezeroaren aldeko scripten mende dago. Hala ere, onuragarria da ordezko inplementazio bat edo azalpen bat ematea scriptak erabilgarri ez dauden inguruneetarako. Ainguren elementuak JavaScript ekintza bati deitzeko erabiltzen direnean, ordezko inplementazioa edo azalpena href atributuaren bidez ematen da. Botoiak erabiltzen direnean, formulario bat bidaliz ematen da.
Adibideak
Script bat exekutatzen duen eta script gabeko nabigatzaileentzako alternatibarik ez duen esteka
Ikuspegi hau scriptetan irisgarritasunarekin bateragarria den teknologia gisa konfiantza dagoenean soilik erabili behar da.
Esteka honetatik nabigatu nahi ez badugu ere, href atributua erabili behar dugu a elementuan, benetako esteka bat izan dadin eta gertaeren tratamendu egokia jaso dezan. Kasu honetan href="#" erabiltzen dugu estekaren helmuga gisa, baina edozer erabil liteke. Esteka honetatik ez da inoiz nabigatuko.
doStuff() gertaera-kudeaketako funtzioaren amaierako «return false;» aginduak nabigatzaileari adierazten dio ez dezala URI-ra nabigatu. Hori gabe, orria berriro kargatuko litzateke scripta exekutatu ondoren.
<script>
function doStuff() {
//do stuff
return false;
}
</script>
<a href="#" onclick="return doStuff();">do stuff</a>
Script bat exekutatzen duen esteka, scriptak erabilgarri ez daudenean beste orri batera nabigatzen duena
Ikuspegi hau scripten mende ez dauden guneak sortzeko erabil daiteke, betiere nabigazioaren helmugak scriptak bezalako funtzionaltasuna eskaintzen badu. Adibide hau 1. adibidearen berdina da, salbu eta orain haren href atributuak benetako orri bat seinalatzen duela, dostuff.html. dostuff.html orriak scriptak bezalako funtzionaltasuna eskaini behar du. doStuff() gertaera-kudeaketako funtzioaren amaierako «return false;» aginduak nabigatzaileari adierazten dio ez dezala URI-ra nabigatu. Hori gabe, nabigatzaileak dostuff.html orrira nabigatuko luke scripta exekutatu ondoren.
<script>
function doStuff() {
//do stuff
return false;
}
</script>
<a href="dostuff.html" onclick="return doStuff();">do stuff</a>
Kode honen adibide funtzional bat dago eskuragarri. Ikus Creating Action Links using JavaScript (ekintza-estekak sortzea JavaScript bidez).
Script bat exekutatzen duen eta script gabeko erabiltzaileentzat formulario baten bidalketara jotzen duen botoia
Ikuspegi hau scripten mende ez dauden guneek erabil dezakete, betiere formularioaren bidalketak scriptak bezalako funtzionaltasuna eskaintzen badu. onsubmit="return false;" aginduak formularioa bidal dadin eragozten du.
<script>
function doStuff() {
//do stuff
}
</script>
<form action="doStuff.aspx" onsubmit="return false;">
<input type="submit" value="Do Stuff" onclick="doStuff();">
</form>
Kode honen adibide funtzional bat dago eskuragarri. Ikus Creating Action Buttons using JavaScript (ekintza-botoiak sortzea JavaScript bidez).
Script bat exekutatzen duen botoia, input type="image" bidez inplementatua
Kontuan izan alt atributu bat gehitu behar zaiola input elementuari, irudiaren testu-baliokide bat emateko. Ikuspegi hau scriptetan konfiantza dagoenean soilik erabili behar da.
<script>
function doStuff() {
//do stuff
return false;
}
</script>
<input type="image" src="stuff.gif" alt="Do stuff" onclick="return doStuff();">
Script bat exekutatzen duen botoia, input type="submit", input type="reset" edo input type="button" bidez inplementatua
Ikuspegi hau scriptetan konfiantza dagoenean soilik erabili behar da.
<input type="submit" onclick="return doStuff();" value="Do Stuff">
Script bat exekutatzen duen botoia, button bidez inplementatua
Botoiaren itxuraren gaineko kontrol handiagoa nahi denean da erabilgarria. Adibide zehatz honetan, botoiak ikono bat eta testua ditu. Ikuspegi hau scriptetan konfiantza dagoenean soilik erabili behar da.
<button onclick="return doStuff();">
<img src="stuff.gif" alt="stuff icon">
Do Stuff
</button>
Probak
Prozedura
a, button edo input elementuekin lotutako script-ekintza guztietarako:
-
Scriptekin bateragarria den erabiltzaile-agente batean
- Egin klik kontrolean saguarekin.
- Egiaztatu scriptaren ekintza behar bezala exekutatzen dela.
- Kontrola aingura-elementu bat bada, egiaztatu ez zaiola aingura-elementuaren
hrefatributuko URI-ari deitzen. - Egiaztatu teklatuaren bidez kontroleraino nabigatu eta hari fokua eman daitekeela.
- Jarri teklatuaren fokua kontrolean.
- Egiaztatu SARTU sakatzean scriptaren ekintzari deitzen zaiola.
- Kontrola aingura-elementu bat bada, egiaztatu ez zaiola aingura-elementuaren
hrefatributuko URI-ari deitzen.
-
Scriptekin bateragarria ez den erabiltzaile-agente batean
- Egin klik kontrolean saguarekin.
- Kontrola aingura-elementu bat bada, egiaztatu aingura-elementuaren
hrefatributuko URI-ari deitzen zaiola. - Egiaztatu teklatuaren bidez kontroleraino nabigatu eta hari fokua eman daitekeela.
- Jarri teklatuaren fokua kontrolean.
- Kontrola aingura-elementu bat bada, egiaztatu SARTU sakatzean aingura-elementuaren
hrefatributuko URI-ari deitzen zaiola.
Espero diren emaitzak
- Aurreko egiaztapen guztiak egiazkoak dira.
Baliabideak
-
HTML - the
scriptelement (HTML espezifikazioa: script elementua) - HTML - Forms (HTML espezifikazioa: formularioak)
-
HTML - the
aelement (HTML espezifikazioa: a elementua)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR35 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.