Teknika Bezero-scriptak WCAG 2.2
SCR20Ekintza bakoitza saguarekin eta teklatuarekin funtziona dezan programatzea
Izen ofiziala W3Cn: Teklatuko funtzioak beste gailu batzuen funtzio espezifikoekin batera erabiltzea
Laburbilduz
Script batek saguaren gertaera bati erantzuten badio, teklatuko baliokideari ere erantzun behar dio. Adibidez, mouseover-ekin batera focus erabiltzen da, eta mousedown-ekin batera keydown. Horrela, orriko edozein funtzio erabil daiteke saguarekin, teklatuarekin edo beste gailu batzuekin.
Zergatik da garrantzitsua
Pertsona askok teklatuarekin soilik nabigatzen dute: pertsona itsuek, dardarak edo mugikortasun urria dituztenek, edo sakagailu bat edo ahots bidezko kontrola erabiltzen dutenek.
Menu bat sagua gainetik pasatzean soilik irekitzen bada, edo produktu-txartel batek div baten gaineko klik bati soilik erantzuten badio, pertsona horiek ezin dituzte erabili.
Nola egiten da
- Ahal duzun guztietan, erabili jatorrizko elementuak,
<button>edo<a href>, adibidez. Haiekin,clickgertaerak Sartu edo Zuriune-barra teklekin funtzionatzen du jada. - Parekatu gertaerak:
mouseoverfocus-ekin,mouseoutblur-ekin,mousedownkeydown-ekin etamouseupkeyup-ekin. - Jatorrizkoa ez den elementu bat erabiltzen baduzu, eman iezaiozu
tabindex="0",roleegoki bat, eta erantzun Sartu eta Zuriune-barra teklei. - Saihestu saguarekin soilik dauden ekintzak, klik bikoitza edo arrastatzea, adibidez, alternatibarik gabe.
Nola egiaztatu
- Egin elkarreragile den guztiaren zerrenda bat: menuak, botoiak, fitxak, karruselak, txartelak.
- Utzi sagua alde batera eta igaro orria Tab, Maius + Tab, Sartu, Zuriune-barra eta gezi-teklekin.
- Egiaztatu elementu bakoitzera iritsi zaitezkeela eta haren funtzio guztiak erabil ditzakezula.
Adibidea
Jatorrizkoa ez den elementu bat, klikari eta Sartu eta Zuriune-barra teklei erantzuten diena.
<div role="button" tabindex="0" id="filtrar">Iragazi emaitzak</div>
<script>
const boton = document.getElementById("filtrar");
boton.addEventListener("click", filtrar);
boton.addEventListener("keydown", (e) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
filtrar();
}
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR20 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Funtzionaltasuna inplementatzeko scriptak erabiltzen dituen eduki guztiari aplikatzen zaio.
Deskribapena
Teknika honen helburua da teklatuaren gertaera espezifikoen eta saguaren gertaera espezifikoen erabilera bateratua erakustea, gertaera bati lotutako script-funtzio bat duen kodean. Teklatuaren gertaera espezifikoak eta saguaren gertaera espezifikoak batera erabiltzeak bermatzen du edukia gailu mota askorekin erabil daitekeela. Adibidez, script batek ekintza bera egin dezake tekla bat sakatu dela hautematen duenean eta saguaren botoi batekin klik egiten denean. Teknika honek betetze-irizpidearen teklatu bidezko sarbidearen betekizuna gainditzen du, teklatu bidezko sarbidea ez ezik beste gailu batzuen bidezko sarbidea ere barne hartzen baitu.
JavaScripten, gehien erabiltzen diren gertaera-kudeatzaileetako batzuk hauek dira: onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onload, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onreset, onselect, onsubmit eta onunload. Saguaren funtzio espezifiko batzuek logikoki baliokidea den teklatuko funtzio espezifiko bat dute («onmouseover» eta «onfocus», adibidez). Saguaren gertaera-kudeatzailearen funtzio bera exekutatzen duen teklatuko gertaera-kudeatzaile bat eman behar da.
Hurrengo taulak saguaren gertaera-kudeatzaileekin parekatzeko teklatuko gertaera-kudeatzaileak iradokitzen ditu.
| Erabili... | ...honekin batera |
|---|---|
mousedown |
keydown |
mouseup |
keyup |
click [1] |
keypress [2] |
mouseover |
focus |
mouseout |
blur |
1 Click, printzipioz, saguaren gertaera-kudeatzaile bat bada ere, HTML erabiltzaile-agente gehienek gertaera hori prozesatzen dute HTML kontrol natibo bat (botoi bat edo esteka bat, adibidez) aktibatzen denean ere, saguarekin edo teklatuarekin aktibatu den kontuan hartu gabe. Praktikan, beraz, ez da beharrezkoa gertaera hori bikoiztea modu natiboan fokua jaso dezaketen HTML elementuei kudeatzaileak gehitzean. Hala ere, beharrezkoa da beste gertaera batzuei kudeatzaileak gehitzean, beherago dagoen 2. adibidean bezala.
2 keypress gertaeraren kudeatzaileak edozein teklari erantzuten dionez, gertaera kudeatzen duen funtzioak egiaztatu behar du, lehenik, Sartu tekla sakatu dela, gertaeraren tratamenduarekin jarraitu aurretik. Bestela, gertaeraren kudeatzailea exekutatu egingo da erabiltzaileak edozein tekla sakatzen duen bakoitzean, baita kontroletik irteteko tabulazio-tekla ere, eta hori ez da nahi izaten, normalean.
Saguaren funtzio espezifiko batzuek (dblclick eta mousemove, adibidez) ez dute teklatuko funtzio espezifiko baliokiderik. Horrek esan nahi du funtzio batzuk gailu bakoitzerako modu desberdinean inplementatu behar izan daitezkeela (adibidez, botoi sorta bat sartuz, inplementatutako saguaren funtzio espezifikoen baliokidea teklatuaren bidez exekutatzeko).
Adibideak
Irudia duen esteka baten adibide honetan, irudia aldatu egiten da erabiltzaileak erakuslea haren gainean jartzen duenean. Teklatuaren erabiltzaileei antzeko esperientzia bat eskaintzeko, irudia aldatu egiten da erabiltzailea tabulazio-teklarekin hara iristen denean ere.
<a href="menu.php" onmouseover="swapImageOn('menu')" onfocus="swapImageOn('menu')"
onmouseout="swapImageOff('menu')" onblur="swapImageOff('menu')">
<img id="menu" src="menu_off.gif" alt="Menu">
</a>
Adibide honek esteka-kontrol pertsonalizatu bat erakusten du, eta funtzioa aktibatzeko sagua zein teklatua erabil daitezke. Saguaren onclick gertaera teklatuko onkeypress gertaera egoki batekin bikoizten da. tabindex atributuak bermatzen du teklatuak tabulazio-geldialdi bat duela span elementuan. Kontuan izan, adibide honetan, nextPage() funtzioak egiaztatu beharko lukeela sakatutako tekla Sartu izan dela; bestela, teklatuko ekintza guztiei erantzungo die span-ak fokua duen bitartean, eta hori ez da nahi den portaera.
<span onclick="nextPage();" onkeypress="nextPage();" role="link" tabindex="0">
<img alt="Go to next page" src="arrow.gif">
</span>Probak
Prozedura
- Aurkitu funtzionaltasun elkarreragile guztia.
- Egiaztatu funtzionaltasun elkarreragile guztia teklatua soilik erabiliz eskura daitekeela.
Espero diren emaitzak
- 2. egiaztapena egiazkoa da.
Baliabideak
- Overview of Creating Accessible JavaScript (JavaScript irisgarria sortzeko sarrera, WebAIM)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR20 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.