Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA4Osagaia zer motatakoa den role atributuarekin adieraztea

Izen ofiziala W3Cn: WAI-ARIAren role atributu bat erabiltzea erabiltzaile-interfazeko osagai baten funtzioa erakusteko

Versión en castellano · Versió en català

Laburbilduz

Osagai bat div, span edo irudiekin neurrira egiten denean, nabigatzaileak ez daki zer den. role atributuak pantaila-irakurgailuari esaten dio tresna-barra bat, fitxa bat, zuhaitz bat edo botoi bat den. Kontrol horretarako HTML etiketa natibo bat badago, hobe da hura erabiltzea.

Zergatik da garrantzitsua

Pantaila-irakurgailuak (pantaila ozen irakurtzen duen programa) elementu bakoitzaren mota iragartzen du: «botoia», «fitxa», «laukia». Datu horri esker, pertsonak badaki zer egin dezakeen elementuarekin.

Fitxa itxura duen <div> bat testu soil gisa iragartzen da. Erabiltzaileak ez daki aktiba dezakeenik, ezta haren barruan nola mugitu ere. Webgunea ahotsez erabiltzen dutenei ere eragiten die, «sakatu Bilatu botoia» bezalako aginduak ematen dituztenean.

Nola egiten da

  1. Erabili lehenik HTML elementu natiboak: <button>, <a>, <select>. Berez dakarte beren funtzioa eta teklatu bidezko erabilera.
  2. Osagaia propioa bada, gehitu WAI-ARIA espezifikazioan definitutako role bat, hala nola toolbar, tablist, tab, tree edo treeitem.
  3. Ez erabili rol abstraktuak, hala nola widget edo landmark. Espezifikazioaren barne-kategoriak dira.
  4. Aukeratu osagaiak egiten duena deskribatzen duen rola, ez zer dirudien. Errespetatu rol bakoitzaren egitura: tab bat tablist baten barruan doa.
  5. Programatu teklatua. role atributuak iragartzen dena bakarrik aldatzen du; ez dio inolako portaerarik gehitzen.
  6. Osatu osagaia izen batekin eta haren rolak behar dituen egoerekin (ARIA5 teknika).

Nola egiaztatu

  1. Bilatu role atributuak kodean. Egiaztatu haien balioa WAI-ARIAren rolen zerrendan dagoela eta ondo idatzita dagoela, minuskulaz.
  2. Alderatu rola osagaiak egiten duenarekin. Adibidez, beste orri batera eramaten duen esteka batek ez du role="button" izan behar.
  3. Nabigatzailearen tresnekin (F12, «Irisgarritasuna» panela), hautatu osagaia eta begiratu haren «Role».
  4. Ibili osagaian zehar teklatuarekin eta pantaila-irakurgailuarekin. Mota zuzena entzun behar duzu, eta osagaia erabiltzeko gai izan behar duzu.

Adibidea

Testu-editore bateko tresna-barra, edukiontzi generiko batekin egina.

<div role="toolbar" aria-label="Testuaren formatua">
  <button type="button">Lodia</button>
  <button type="button">Etzana</button>
  <button type="button">Azpimarratua</button>
</div>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA4 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 elementu baten funtzioa definitzea role atributua erabiliz, WAI-ARIAren rolen definizioan definitutako balio ez-abstraktuetako batekin. WAI-ARIA espezifikazioak rol bakoitzaren deskribapen informatiboa ematen du, baita rol bakoitzak beste rol batzuekin duen erlazioarena eta rol bakoitzaren egoera eta propietateena ere. Interneteko aplikazio aberatsek erabiltzaile-interfazeko osagai (widget) berriak definitzen dituztenean, rolak erakusteak aukera ematen die erabiltzaileei osagaia ulertzeko eta harekin nola elkarreragin jakiteko.

Adibideak

Tresna-barra sinple bat

Hiru botoi dituen tresna-barra bat. div elementuak "toolbar" rola du, eta img elementuek "button" rola:

<div role="toolbar"
   tabindex="0"
   id="customToolbar"
   onkeydown="return optionKeyEvent(event);"
   onkeypress="return optionKeyEvent(event);"
   onclick="return optionClickEvent(event);"
   onblur="hideFocus()"
   onfocus="showFocus()"
   >
   <img src="img/btn1.gif"
        role="button"
        tabindex="-1"
        alt="Home"
        id="b1"
        title="Home">
   <img src="img/btn2.gif"
        role="button"
        tabindex="-1"
        alt="Refresh"
        id="b2"
        title="Refresh">
  <img src="img/btn3.gif"
        role="button"
        tabindex="-1"
        alt="Help"
        id="b3"
        title="Help">
</div>  

Egileentzako jardunbideen gidako tresna-barraren ereduak (Toolbar Pattern) tresna-barra funtzional baten adibidea eskaintzen du.

Zuhaitz-osagai bat

Oinarrizko zuhaitz-osagai bat. Ohartu nola erabiltzen diren "tree", "treeitem" eta "group" rolak zuhaitza eta haren egitura identifikatzeko. Hau kodearen zati sinplifikatu bat da:

<ul role="tree" tabindex="0">
   <li role="treeitem">Birds</li>
   <li role="treeitem">Cats
     <ul role="group">
       <li role="treeitem">Siamese</li>
       <li role="treeitem">Tabby</li>
     </ul>
   </li>
   <li role="treeitem">Dogs
     <ul role="group">
       <li role="treeitem">Small Breeds
         <ul role="group">
           <li role="treeitem">Chihuahua</li>
           <li role="treeitem">Italian Greyhound</li>
           <li role="treeitem">Japanese Chin</li>
         </ul>
       </li>
       <li role="treeitem">Medium Breeds
         <ul role="group">
           <li role="treeitem">Beagle</li>
           <li role="treeitem">Cocker Spaniel</li>
           <li role="treeitem">Pit Bull</li>
         </ul>
       </li>
       <li role="treeitem">Large Breeds
         <ul role="group">
           <li role="treeitem">Afghan</li>
           <li role="treeitem">Great Dane</li>
           <li role="treeitem">Mastiff</li>
         </ul>
       </li>
     </ul>
   </li>
 </ul>

Egileentzako jardunbideen gidako zuhaitz-ikuspegiaren ereduak (Tree View Pattern) zuhaitz funtzional baten adibidea eskaintzen du.

Probak

Prozedura

role atributua erabiltzen duen erabiltzaile-interfazeko osagai baterako:

  1. Egiaztatu role atributuaren balioa WAI-ARIA espezifikazioan definitutako balioen artean dauden rol ez-abstraktuetako bat dela.
  2. Egiaztatu erabiltzaile-interfazeko osagaiaren ezaugarriak bat datozela rolaren deskribapenarekin.

Espero diren emaitzak

  • 1. eta 2. 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 ARIA4 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.