Addaw, joan hasierara Egin dohaintza

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

Versión en castellano · Versió en català

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

  1. Ekintzak orrian zerbait aldatzen badu (erakutsi, ezkutatu, gehitu, kalkulatu), erabili <button type="button">.
  2. Beste leku batera eramaten badu, erabili href duen <a> esteka bat. href gabe ez du fokua jasotzen.
  3. Lotu scripta click gertaerarekin. Izenak sagua iradoki arren, teklatuarekin ere abiarazten da: estekak Sartu teklarekin, eta botoiak Sartu edo Zuriune-barrarekin.
  4. Ez abiarazi ekintza saguarenak soilik diren gertaerekin, hala nola mousedown edo mouseover.
  5. Orriak JavaScript gabe funtzionatu behar badu, eman alternatiba bat. Funtzio bera duen orri baterako href bat izan daiteke, edo zerbitzarira bidaltzen den formulario bat.
  6. Botoia irudi bat bada (<input type="image">), jarri zer egiten duen esaten duen alt bat.

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.

Adibide okerraren pantaila-argazkia: onclick duen eta botoiarena egiten duen div bat
Horrela ikusten da adibide okerra.

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

Teklatua

  1. Ibili orrian zehar Tab teklarekin. Kontrolak fokua jaso behar du, eta fokuak ikusgai egon behar du.
  2. Sakatu Sartu eta, ondoren, Zuriune-barra. Bi teklek ordutegia erakutsi edo ezkutatu behar dute.
  3. Alderatu saguarekin: klikak egiten duen guztia teklatuarekin ere egin ahal izan behar da.

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. Jarri fokua kontrolean. Botoi gisa eta bere egoerarekin iragarri behar da.
  2. Aktibatu. Egoerak «zabalduta» izatera aldatu behar du.

Hau iragarri beharko luke: «Ikusi arreta-ordutegia, botoia, tolestuta»

Nabigatzailearen tresnak

  1. Ireki nabigatzailearen tresnak (F12), Elementuak fitxa. Bilatu onclick atributuak edo klik-entzuleak («Event Listeners» panela) div, span, li edo img elementuetan.
  2. Irisgarritasuna fitxan, egiaztatu ekintza duen elementu bakoitzak botoi- edo esteka-funtzioa duela eta fokua jasotzen duela.

Balidazio automatikoa

  1. axe DevTools-ek, WAVEk eta Lighthouse-k ez dute ondo detektatzen onclick duen div bat. Ez dakite elementu batek gertaera-entzuleak dituen ala ez.
  2. Horregatik, teklatuarekin egindako proba ezinbestekoa da 2.1.1 irizpiderako. Tresna automatikoek elementuak izenik edo tabindex-ik gabeko ARIA funtzio bat badu soilik laguntzen dute.

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:

  1. 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 href atributuko 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 href atributuko URI-ari deitzen.
  2. Scriptekin bateragarria ez den erabiltzaile-agente batean

    • Egin klik kontrolean saguarekin.
    • Kontrola aingura-elementu bat bada, egiaztatu aingura-elementuaren href atributuko 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 href atributuko URI-ari deitzen zaiola.

Espero diren emaitzak

  • Aurreko egiaztapen guztiak egiazkoak dira.

Baliabideak

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