Addaw, joan hasierara Egin dohaintza

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

Versión en castellano · Versió en català

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

  1. Identifikatu osagaiak zer egoera dituen: irekita edo itxita, markatuta edo ez, uneko balioa.
  2. Erabili atributu egokia: aria-expanded zabalgarrietarako, aria-pressed aktibatu eta desaktibatzeko botoietarako, aria-checked kontrol-lauki propioetarako eta aria-selected fitxetarako.
  3. Jarri rol bakoitzaren derrigorrezko atributuak. Adibidez, role="slider" batek aria-valuenow behar du, eta komeni da aria-valuemin eta aria-valuemax ere ematea.
  4. Ez erabili rolak onartzen ez dituen atributuak. WAI-ARIA espezifikazioak adierazten du rol bakoitzak zein onartzen dituen.
  5. Aldatu balioa JavaScript bidez, ikusten dena aldatzen den une berean.

Nola egiaztatu

  1. Ireki nabigatzailearen tresnak (F12), hautatu osagaia eta begiratu haren egoerak «Irisgarritasuna» panelean.
  2. Erabili osagaia saguarekin edo teklatuarekin. Egiaztatu kodean atributuaren balioa aldatzen dela; adibidez, false-tik true-ra.
  3. Berrikusi rolaren derrigorrezko atributuak badaudela eta bat bera ere ez dagoela soberan. axe edo WAVE bezalako tresnek errore horietako askoren berri ematen dute.
  4. 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:

  1. Egiaztatu rolarentzat derrigorrezkoak diren egoerak eta propietateak badaudela.
  2. Egiaztatu ez dagoela derrigorrezkoa, onartua edo heredatua ez den WAI-ARIAren egoera edo propietaterik.
  3. 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

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