Teknika ARIA WCAG 2.2
ARIA5Osagai baten egoera ARIA atributuekin jakinaraztea
Izen ofiziala W3Cn: WAI-ARIAren egoera- eta propietate-atributuak erabiltzea erabiltzaile-interfazeko osagai baten egoera erakusteko
Laburbilduz
Osagai asko aldatu egiten dira: menu bat ireki egiten da, botoi bat sakatuta geratzen da, graduatzaile batek balio bat markatzen du. ARIAren egoera-atributuek, hala nola aria-expanded, aria-pressed edo aria-valuenow atributuek, aldaketa horiek pantaila-irakurgailuari helarazten dizkiote. JavaScript bidez eguneratu behar dira egoera aldatzen den bakoitzean.
Zergatik da garrantzitsua
Pantaila ikusten duen pertsona batek ohartzen da menua zabaldu dela edo isilarazteko botoia aktibatuta dagoela. Pantaila-irakurgailua (pantaila ozen irakurtzen duen programa) erabiltzen duenak kodeak esaten diona bakarrik daki.
Atributu horiek gabe, «Menua botoia» entzungo du, eta ez du jakingo menua irekita dagoen. Atributua badago baina eguneratzen ez bada, okerragoa da: informazio faltsua jasoko du.
Nola egiten da
- Identifikatu osagaiak zer egoera dituen: irekita edo itxita, markatuta edo ez, uneko balioa.
- Erabili atributu egokia:
aria-expandedzabalgarrietarako,aria-pressedaktibatu eta desaktibatzeko botoietarako,aria-checkedkontrol-lauki propioetarako etaaria-selectedfitxetarako. - Jarri rol bakoitzaren derrigorrezko atributuak. Adibidez,
role="slider"batekaria-valuenowbehar du, eta komeni daaria-valueminetaaria-valuemaxere ematea. - Ez erabili rolak onartzen ez dituen atributuak. WAI-ARIA espezifikazioak adierazten du rol bakoitzak zein onartzen dituen.
- Aldatu balioa JavaScript bidez, ikusten dena aldatzen den une berean.
Nola egiaztatu
- Ireki nabigatzailearen tresnak (F12), hautatu osagaia eta begiratu haren egoerak «Irisgarritasuna» panelean.
- Erabili osagaia saguarekin edo teklatuarekin. Egiaztatu kodean atributuaren balioa aldatzen dela; adibidez,
false-tiktrue-ra. - Berrikusi rolaren derrigorrezko atributuak badaudela eta bat bera ere ez dagoela soberan. axe edo WAVE bezalako tresnek errore horietako askoren berri ematen dute.
- Pantaila-irakurgailu batekin, aktibatu osagaia. Egoera berria entzun behar duzu: «sakatuta», «zabalduta» edo balio berria.
Adibidea
Bideo bat isilarazteko botoia, isilunea aktibatuta dagoen adierazten duena.
<button type="button" id="silencio" aria-pressed="false">Isilarazi</button>
<script>
const boton = document.getElementById('silencio');
boton.addEventListener('click', () => {
const activo = boton.getAttribute('aria-pressed') === 'true';
boton.setAttribute('aria-pressed', String(!activo));
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko ARIA5 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Accessible Rich Internet Applications (WAI-ARIA) onartzen duten teknologiak.
Deskribapena
Teknika honen helburua da WAI-ARIAren egoera- eta propietate-atributuak erabiltzea erabiltzaile-interfazeko osagai baten egoera, propietateak eta balioak erakusteko, laguntza-teknologiek irakurri eta ezarri ahal izan ditzaten, eta balio horietan gertatzen diren aldaketen jakinarazpena jaso dezaten. WAI-ARIA espezifikazioak atributu bakoitzaren deskribapen arauemailea ematen du, baita atributu horrek onartzen dituen erabiltzaile-interfazeko elementuen rolarena ere. Interneteko aplikazio aberatsek erabiltzaile-interfazeko osagai (widget) berriak definitzen dituztenean, egoera- eta propietate-atributuak erakusteak aukera ematen die erabiltzaileei osagaia ulertzeko eta harekin nola elkarreragin jakiteko.
Adibideak
Txandakatze-botoi bat
button rola duen osagai bat txandakatze-botoi gisa jokatzen du aria-pressed atributua inplementatzen duenean. aria-pressed true denean, botoia «sakatuta» egoeran dago. aria-pressed false denean, ez dago sakatuta. Atributua ez badago, botoia agindu-botoi soil bat da.
Ondorengo zatiak, ARIA egileentzako jardunbideen gidako (APG) botoi-adibideetatik hartua, audioa isilarazteko edo aktibatzeko txandakatze-botoi baten WAI-ARIA markaketa erakusten du:
<a tabindex="0"
role="button"
id="toggle"
aria-pressed="false">
Mute
...
</a>
a elementuak role="button" bat eta aria-pressed atributu bat ditu. Adibide honen JavaScript kodearen ondorengo zatiak aria-pressed atributuaren balioa eguneratzen du:
/**
* Toggles the toggle button's state between *pressed* and *not pressed*.
*
* @param {HTMLElement} button
*/
function toggleButtonState(button) {
var isAriaPressed = button.getAttribute('aria-pressed') === 'true';
button.setAttribute('aria-pressed', isAriaPressed ? 'false' : 'true');
...
}
Graduatzaile bat
slider rola duen osagai batek aukera ematen dio erabiltzaileari tarte jakin bateko balio bat hautatzeko. Graduatzaileak uneko balioa eta balio posibleen tartea adierazten ditu, kontrolaren beraren tamainaren eta heldulekuaren posizioaren bidez. Graduatzailearen propietate horiek aria-valuemin, aria-valuemax eta aria-valuenow atributuekin adierazten dira.
Ondorengo zatiak, ARIA egileentzako jardunbideen gidako (APG) koloreak bistaratzeko graduatzailearen adibidetik hartua, graduatzaileetako baten WAI-ARIA markaketa erakusten du:
<div id="id-red" class="color-slider-label">Red</div>
<div class="color-slider red"
role="slider"
tabindex="0"
aria-valuemin="0"
aria-valuenow="128"
aria-valuemax="255"
aria-labelledby="id-red">
...
</div>
Adibide honen JavaScript kodearen ondorengo zatiak aria-valuenow atributuaren balioa eguneratzen du graduatzailearen heldulekuaren balioa aldatzen denean:
moveSliderTo(slider, value) {
...
slider.sliderNode.setAttribute('aria-valuenow', value);
...
}
Probak
Prozedura
WAI-ARIA espezifikazioaren 5.3 atalak, Rolen sailkapena izenekoak, rol bakoitzaren derrigorrezko egoerak eta propietateak eta heredatutakoak definitzen ditu.
WAI-ARIAren role atributua erabiltzen duen erabiltzaile-interfazeko osagai baterako:
- Egiaztatu rolarentzat derrigorrezkoak diren egoerak eta propietateak badaudela.
- Egiaztatu ez dagoela derrigorrezkoa, onartua edo heredatua ez den WAI-ARIAren egoera edo propietaterik.
- Egiaztatu egoeren eta propietateen balioak eguneratu egiten direla uneko egoera islatzeko, erabiltzaile-interfazeko osagaiak egoeraz aldatzen duenean.
Espero diren emaitzak
- 1., 2. eta 3. egiaztapenak egiazkoak dira.
Baliabideak
- Accessible Rich Internet Applications (WAI-ARIA), Roles (rolei buruzko atala)
- Accessible Rich Internet Applications (WAI-ARIA), The Roles Model (rolen eredua)
- Accessible Rich Internet Applications (WAI-ARIA), Supported States and Properties (onartutako egoerak eta propietateak)
- WAI-ARIA Authoring Practices Guide (WAI-ARIA egileentzako jardunbideen gida)
- Using WAI-ARIA in HTML (WAI-ARIAren erabilera HTMLn)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren ARIA5 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.