Addaw, joan hasierara Egin dohaintza

Teknika Bezero-scriptak WCAG 2.2

SCR29Ekintzak dituzten div edo span elementuak teklatuarekin funtzionaraztea

Izen ofiziala W3Cn: Teklatu bidez irisgarriak diren ekintzak HTML elementu estatikoei gehitzea

Versión en castellano · Versió en català

Laburbilduz

div edo span elementu batek zerbait egiten badu sakatzean, teklatuarekin ere funtzionatu behar du. Horretarako, tabindex="0" behar du fokua jasotzeko, eta Sartu eta Zuriune-barra teklei erantzuten dien script bat. Gainera, zer den adierazi behar du, role="button" erabiliz, adibidez. Ahal den guztietan, hobe da botoi bat zuzenean erabiltzea.

Zergatik da garrantzitsua

div eta span elementuek ez dute berez fokua jasotzen, ezta teklatuari erantzuten ere. Klik-gertaera bat besterik ez badute, sagua erabiltzen ez duenak ezin ditu aktibatu.

Horrek eragina du pertsona itsuengan, dardarak dituztenengan edo mugikortasun murriztua dutenengan. Adibidez, span batekin egindako «Ordutegiak» fitxa ezinezkoa litzateke sagurik gabe irekitzea.

Nola egiten da

  1. Lehenik, aztertu <button> bat edo esteka bat erabil dezakezun. Berez dakarte fokua, teklatua eta funtzio zuzena, kode gehigarririk gabe.
  2. Elementu generiko bat behar baduzu, gehitu tabindex="0". Horrela, tabulazio-ordenan sartzen da. tabindex="-1" erabiliz gero, script batetik soilik jasotzen du fokua.
  3. Gehitu role="button" (edo dagokion funtzioa) eta izen argi bat. Horiek gabe, pantaila-irakurgailuak ez daki kontrol bat denik.
  4. click gertaeraz gain, entzun keydown edo keyup. Abiarazi ekintza bera Sartu teklarekin eta Zuriune-barrarekin.
  5. Ziurtatu fokua ikusten dela, :focus-visible egoeran ingerada bat jarrita, adibidez.
  6. Irtenbide hau JavaScripten mende dago. Erabili soilik orriak funtzionatzeko lehendik behar badu.

Nola egiaztatu

  1. Egin klik kontrolean saguarekin eta egiaztatu ekintzak funtzionatzen duela.
  2. Ibili orrian zehar Tab teklarekin. Kontrolak fokua jaso behar du, eta fokuak ikusgai egon behar du.
  3. Fokua kontrolean dagoela, sakatu Sartu eta, ondoren, Zuriune-barra. Bi teklek abiarazi behar dute ekintza.
  4. Pantaila-irakurgailu batekin, egiaztatu haren funtzioa (adibidez, «botoia») eta izena iragartzen direla.

Adibidea

Egoitza baten helbidea erakusten duen eta saguari, Sartu teklari eta Zuriune-barrari erantzuten dien div bat.

<div id="ver-mapa" class="accion" tabindex="0" role="button">Ikusi egoitzaren helbidea</div>
<p id="mapa" hidden>Kale Nagusia, 1. Beheko solairua.</p>
<script>
var control = document.getElementById('ver-mapa');
function mostrarMapa() { document.getElementById('mapa').hidden = false; }
control.addEventListener('click', mostrarMapa);
control.addEventListener('keydown', function (e) {
  if (e.key === 'Enter' || e.key === ' ') {
    e.preventDefault(); // Zuriune-barrak orria korritzea saihesten du
    mostrarMapa();
  }
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

HTML, scriptak

Deskribapena

Teknika honen helburua da erakustea nola eman teklatu bidezko sarbidea div edo span bezalako HTML elementu estatikoei lotutako ekintzen bidez inplementatutako erabiltzaile-interfazeko kontrol bati. Teknika honek bermatzen du elementuak fokua jaso dezakeela, tabindex atributua ezarrita, eta bermatzen du ekintza teklatutik aktiba daitekeela, onclick kudeatzaileaz gain onkeyup edo onkeypress kudeatzaile bat emanez.

tabindex atributuaren balioa 0 denean, elementuak teklatu bidez jaso dezake fokua, eta dokumentuaren tabulazio-ordenan sartzen da. tabindex atributuaren balioa -1 denean, ezin da elementura iritsi tabulazio-teklarekin, baina fokua programatikoki eman dakioke element.focus() erabiliz.

HTML elementu estatikoek lotutako ekintzarik ez dutenez, ezin da inplementazio alternatiborik edo azalpenik eman scriptak erabilgarri ez dauden inguruneetan. Teknika hau bezeroaren aldeko scriptetan konfiantza izan daitekeen inguruneetan soilik erabili behar da.

Erabiltzaile-interfazeko kontrol horiek 4.1.2 Izena, funtzioa eta balioa betetze-irizpidea bete behar dute, hala ere. Teknika hau aplikatzen bada erabiltzaile-interfazeko kontrolaren funtzioari, izenari eta egoerari buruzko informazioa ere eman gabe, F59 akatsa gertatuko da: 4.1.2 betetze-irizpidearen akatsa, HTMLn div edo span bat erabiltzaile-interfazeko kontrol bihurtzeko scriptak erabiltzeagatik.

Adibideak

JavaScript ekintza bat div elementu bati gehitzea

Orriko div elementuari id atributu esklusibo bat eta 0 balioa duen tabindex atributu bat esleitzen zaizkio. Script batek dokumentuaren objektu-eredua (DOM) erabiltzen du div elementua bere idaren bidez aurkitzeko eta onclick eta onkeyup kudeatzaileak gehitzeko. onkeyup kudeatzaileak ekintza abiaraziko du Sartu tekla sakatzen denean. Kontuan izan div elementuak DOMean kargatuta egon behar duela hura aurkitu eta aldatu ahal izateko. Hori, normalean, body elementuaren onload gertaeratik scripta deituta lortzen da. Gertaera-kudeatzaileak gehitzen dituen scripta erabiltzaile-agenteak JavaScript onartzen badu eta aktibatuta badauka soilik exekutatuko da.

<script>
// this is the function to perform the action. This simple example toggles a message.
function doSomething(event) {
  var msg=document.getElementById("message");
  msg.style.display = msg.style.display=="none" ? "" : "none";
  //return false from the function to make certain
  // that the href of the link does not get invoked
  return false;
  }
  // this is the function to perform the action when the Enter key has been pressed.  
  function doSomethingOnEnter(event) {
    var key = 0;
     // Determine the key pressed, depending on whether window.event
    // or the event object is in use
    if (window.event) {
      key = window.event.keyCode;
    }
    else if (event) {
      key = event.keyCode;
    }
    // Was the Enter or Space key pressed?
    if (key == 13 || key == 32) {
      return doSomething(event);
    } 
    // The event has not been handled, so return true
    return true;
  }
  // This setUpActions() function must be called to set the onclick and onkeyup
  // event handlers onto the existing div element.
  // This function must be called after the div element with id="active" 
  // has been loaded into the DOM.
  // In this example the setUpActions() function is called from the onload event
  // for the body element.
  function setUpActions() {
    // get the div object
    var active=document.getElementById("active");
    // assign the onclick handler to the object.
    active.onclick=doSomething;
    // assign the onkeyup handler to the object.
    active.onkeyup=doSomethingOnEnter;
}
</script>
<body onload="setUpActions();">
  <p>Here is the link to modify with a javascript action:</p>
  <div>
    <span id="active" role="button" tabindex="0">Do Something</span>
  </div>
  <div aria-live="polite">
    <div id="message">Hello, world!</div>
  </div>
</body>

Kode honen adibide funtzionala: Creating Divs with Actions using JavaScript (ekintzak dituzten div elementuak JavaScript bidez sortzea).

Probak

Prozedura

Scriptak onartzen dituen erabiltzaile-agente batean:

  1. Kontrolean klik egitea saguarekin.
  2. Egiaztatzea scriptaren ekintza behar bezala exekutatzen dela.
  3. Egiaztatzea kontrolera nabigatu eta hari fokua eman dakiokeela teklatu bidez.
  4. Teklatu-fokua kontrolean jartzea.
  5. Egiaztatzea Sartu edo Zuriune-barra sakatzean scriptaren ekintza abiarazten dela.

Espero diren emaitzak

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