Addaw, joan hasierara Egin dohaintza

Ohiko akatsa WCAG 2.2

F59Zer diren esaten ez duten div edo span bidezko kontrolak

Izen ofiziala W3Cn: 4.1.2 betetze-irizpidearen akatsa, scriptak erabiltzeagatik div edo span bat HTMLko erabiltzaile-interfazeko kontrol bihurtzeko, kontrolari funtziorik (role) eman gabe

Versión en castellano · Versió en català

Laburbilduz

Botoi, kontrol-lauki edo fitxa bat div edo span batekin eta JavaScriptekin egiten denean gertatzen da, haren funtzioa adierazi gabe. Pantaila-irakurgailuak ez daki zer den elementu hori, ezta zer egoeratan dagoen ere. Onena HTMLko jatorrizko elementua erabiltzea da; ezin bada, ARIAren role egokia gehitu behar da.

Zergatik da garrantzitsua

Pantaila-irakurgailuak (pantailan dagoena ozen irakurtzen duen programa) kontrol bakoitza bere motarekin iragartzen du: «botoia», «kontrol-laukia, markatuta», «fitxa». Horrela, pertsonak badaki zer egin dezakeen harekin.

div eta span elementuek ez dute berezko funtziorik. Kontrol-lauki baten itxura izan arren, irakurgailuak haien testua baino ez du irakurtzen. Pertsonak ez daki saka dezakeela, ezta markatuta dagoen ere. Gainera, elementu horiek ez dute teklatu-fokua berez jasotzen.

Nola saihestu

  1. Erabili lehenik jatorrizko elementua: <button>, <input type="checkbox">, <a href> edo <select>. Funtzioa, egoera eta teklatu bidezko erabilera dakartzate jada.
  2. div edo span bat erabili behar baduzu, gehitu ARIAren role bat, hala nola role="checkbox" edo role="button". ARIA pantaila-irakurgailuei informazio gehigarria ematen dieten atributuak dira.
  3. Adierazi egoera aria-checked edo aria-pressed bezalako atributuekin, eta eguneratu scriptetik.
  4. Eman fokua tabindex="0" bidez eta programatu ohiko teklak, adibidez Zuriune-barra kontrol-lauki batean.
  5. Ziurtatu kontrolak izen bat duela, adibidez haren testu ikusgaia.

Nola egiaztatu

  1. Bilatu onclick bezalako gertaerak dituzten div edo span elementuak. Firefoxen, «Inspector» fitxak «event» markarekin adierazten ditu gertaerak dituzten elementuak.
  2. Haietako bakoitzean, egiaztatu role egoki bat duen.
  3. Nabigatzailearen tresnetako (F12) «Irisgarritasuna» panelean, begiratu haren funtzioa («Role»). Ez luke «generic» izan behar, ezta hutsik egon ere.
  4. Iritsi kontrolera NVDArekin edo VoiceOverrekin. Haren mota eta egoera iragarri behar ditu.

Adibidea

Jatorrizko kontrol-lauki bat eta, beste erremediorik ez badago, funtzioa, egoera eta fokua dituen span bat (scriptak Zuriune-barra tekla ere kudeatu behar du).

<!-- Aukerarik onena: jatorrizko kontrol-laukia -->
<label>
  <input type="checkbox"> Sartu sinadura
</label>

<!-- Beste erremediorik ez badago: role eta egoera dituen span-a -->
<span role="checkbox" aria-checked="false" tabindex="0">
  Sartu sinadura
</span>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko F59 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

HTML

Deskribapena

Akats honek erakusten du HTML elementu generikoak erabiltzeak erabiltzaile-interfazeko kontrolak sortzeko nola egin ditzakeen kontrol horiek irisgarriak ez direnak laguntza-teknologientzat. Laguntza-teknologiek osagai baten funtzioa eta uneko egoera ezagutu behar dituzte informazio hori erabiltzaileari helarazi ahal izateko. HTML elementu askok funtzio ondo definituak dituzte, hala nola estekek, botoiek, testu-eremuek eta abarrek. div eta span bezalako elementu generikoek ez dute aurrez zehaztutako funtziorik. Elementu generiko horiek HTMLko erabiltzaile-interfazeko kontrolak sortzeko erabiltzen direnean, baliteke laguntza-teknologiak ez izatea kontrola deskribatzeko eta harekin elkarreragiteko behar duen informazioa.

Normalean interaktiboak ez diren elementuei, hala nola span eta div elementuei, gertaera-kudeatzaileak lotzeak desorientatu egin ditzake erabiltzaileak. Elementu horiei teklatu bidezko sarbidea emateko kontuz ibili arren, erabiltzaileei kosta egin dakieke edukian kontrol interaktiboak daudela konturatzea edo haiengandik zer portaera espero behar duten ulertzea. Adibidez, baliteke erabiltzaileek ez jakitea zer tekla-sakatze onartzen dituen scriptak elementua aktibatzeko. Gainera, elementu horiek ez dituzte sortzen elementu interaktiboek sortzen dituzten sistema eragilearen gertaera berberak; beraz, baliteke laguntza-teknologiak jakinarazpenik ez jasotzea erabiltzaileak haiek aktibatzen dituenean.

Accessible Rich Internet Applications (WAI-ARIA) espezifikazioak funtzioari eta egoerari buruzko beharrezko informazioa emateko mekanismoak deskribatzen ditu, erabat irisgarriak diren erabiltzaile-interfazeko kontrolak sortzeko.

Adibideak

Hurrengo adibideak ez du irizpidea betetzen, kontrol-lauki bat span batekin eta irudi batekin sortzen duelako.

<p> 
   <span onclick="toggleCheckbox('chkbox')"> 
     <img src="unchecked.gif" id="chkbox" alt=""> Include Signature 
   </span> 
</p>

Hau da span elementuan saguarekin klik egitean irudiaren jatorria aldatzen duen scriptaren kodea.

var CHECKED = "check.gif"; 
var UNCHECKED = "unchecked.gif"; 
function toggleCheckbox(imgId) { 
  var theImg = document.getElementById(imgId); 
  if (theImg.src.lastIndexOf(CHECKED)!= -1) {
    theImg.src = UNCHECKED; 
    // additional code to implement unchecked action 
  } 
  else { 
    theImg.src = CHECKED; 
    // additional code to implement checked action 
  } 
}

Modu honetan sortutako kontrol-lauki batek ez du funtzionatuko laguntza-teknologiekin, ez baitago kontrol-lauki gisa identifikatzen duen inolako informaziorik. Gainera, adibide hau ezin da teklatuarekin erabili; beraz, ez luke 2.1 jarraibidea beteko.

Probak

Prozedura

  1. Aztertu prozesatutako iturburu-kodea, markaketan edo scripten bidez gertaera-kudeatzaileak esleituta dituzten elementuen bila (horrek adierazten du elementua erabiltzaile-interfazeko kontrol bat dela).
  2. Egiaztatu kontrolaren funtzioa markaketa-lengoaian berez definituta dagoen.
  3. Egiaztatu kontrolaren funtzioa definitzeko baliozko beste metodoren bat erabili den, hala nola WAI-ARIAren role egoki bat esleitzea.

Espero diren emaitzak

2. ETA 3. egiaztapenak faltsuak badira, akats-baldintza gertatzen da.

Baliabideak

Nola egiaztatzen dugun ADDAWn

Akats hau ADDAWren auditoria bakoitzean bilatzen ditugunetako bat da. Pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizugu.

Eskatu auditoria bat

W3Cren F59 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.