Addaw, joan hasierara Egin dohaintza

Teknika Bezero-scriptak WCAG 2.2

SCR2Irudi apaingarri bat aldatzea, bai saguarekin, bai teklatuarekin

Izen ofiziala W3Cn: Teklatuko eta saguko gertaera-kudeatzaile erredundanteak erabiltzea

Versión en castellano · Versió en català

Laburbilduz

Batzuetan, esteka batek irudi apaingarri bat aldatzen du sagua gainetik pasatzean. Aldaketa bera gertatu behar da estekak teklatuaren fokua jasotzen duenean. Horretarako, saguaren gertaerei teklatuko baliokideak gehitzen zaizkie: focus eta blur.

Zergatik da garrantzitsua

Pertsona askok ez dute sagurik erabiltzen: mugikortasun urria duten pertsonek, pertsona itsuek edo tabuladorearekin nabigatzen dutenek. Efektu batek saguari bakarrik erantzuten badio, pertsona horiek esperientzia desberdin edo osatu gabe bat jasotzen dute.

Gainera, fokua jasotzean gertatzen den aldaketa bisualak laguntzen du une bakoitzean teklatua non dagoen ikusten.

Nola egiten da

  1. Aplikatu efektua fokua jasotzen duen elementu batean, <a href> esteka batean edo botoi batean, adibidez.
  2. mouseover-ekin batera, erabili focus. mouseout-ekin batera, erabili blur. Biek funtzio berari deitu behar diote.
  3. Irudia apaingarria bada, utzi alt=""-rekin, pantaila-irakurgailuak jaramonik egin ez diezaion.
  4. Erabili tamaina bereko irudiak, orria mugi ez dadin.
  5. Gaur egun, askotan nahikoa da CSS erabiltzea: konbinatu :hover eta :focus-visible arau berean.

Nola egiaztatu

  1. Pasatu sagua estekaren gainetik eta begiratu irudiaren aldaketari.
  2. Kargatu berriro orria eta iritsi esteka berera tabuladorearekin.
  3. Egiaztatu irudia berdin aldatzen dela fokua jasotzean eta bere egoerara itzultzen dela irtetean.

Adibidea

Irudi-aldaketa bera saguarentzat eta teklatuarentzat.

const enlace = document.getElementById("enlace-agenda");
const icono = document.getElementById("icono-agenda");
function activar() { icono.src = "agenda-activa.png"; }
function desactivar() { icono.src = "agenda.png"; }
enlace.addEventListener("mouseover", activar);
enlace.addEventListener("focus", activar);
enlace.addEventListener("mouseout", desactivar);
enlace.addEventListener("blur", desactivar);
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

Scriptak onartzen dituen HTML.

Deskribapena

Teknika honen helburua da gailuarekiko independenteak diren gertaerak erabiltzea erakustea, irudi apaingarri bat saguaren edo fokuaren gertaera bati erantzunez aldatzeko. Erabili onmouseover eta onmouseout gertaerak irudi apaingarri bat aldatzeko sagua orriko elementu baten gainean jartzen denean edo handik urruntzen denean. Gainera, erabili onfocus eta onblur gertaerak irudia aldatzeko elementuak fokua jasotzen eta galtzen duenean.

Hurrengo adibideak irudi apaingarri bat du aingura-elementu (esteka) baten aurrean. Erabiltzaileak sagua aingura-etiketaren gainetik pasatzen duenean, aingura aurrean dagoen irudi apaingarria aldatu egiten da. Sagua aingutik urruntzen denean, irudia jatorrizko bertsiora itzultzen da. Irudia aldatzeko efektu bera gertatzen da erabiltzaileak teklatuaren fokua aingura-elementuari ematen dionean. Fokua jasotzean, irudia aldatu egiten da, eta, galtzean, irudia jatorrizko egoerara itzultzen da. Hori lortzeko, onmouseover, onmouseout, onfocus eta onblur gertaeren kudeatzaileak lotzen zaizkio aingura-elementuari. Gertaera-kudeatzailea updateImage() izeneko JavaScript funtzio bat da, irudiaren src atributua aldatzen duena. updateImage() funtzioari deitzen zaio onmouseover, onmouseout, onfocus eta onblur gertaerei erantzunez.

Irudi bakoitzari id bakar bat esleitzen zaio. id bakar hori updateImage() funtzioari pasatzen zaio, zein irudi erabili behar den adierazten duen balio boolear batekin batera: updateImage(imgId, isOver);. true balio boolearra pasatzen da sagua aingura-elementuaren gainean dagoenean edo elementuak fokua duenean. false balioa pasatzen da sagua aingura-elementutik urruntzen denean edo elementuak fokua galtzen duenean. updateImage() funtzioak irudiaren id-a erabiltzen du hura kargatzeko, eta, ondoren, src atributua aldatzen du balio boolearraren arabera. Kontuan izan, irudia apaintzeko denez, haren alt atributua nulua dela.

Gomendagarria da antzeko tamainako irudiak erabiltzea eta irudi-elementuan height eta width atributuak zehaztea. Horrela, irudia eguneratzen denean orriaren diseinuan aldaketarik gertatzea saihesten da. Adibide honek tamaina bereko irudiak erabiltzen ditu.

Adibideak

<!doctype html>
  <html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Changing Image Source in a Device Independent Manner</title>
    <script>
       /* This function will change the image src of an image element.
        * param imgId - the id of the image object to change
        * param isOver - true when mouse is over or object has focus,
         false when mouse move out or focus is lost
       */
       function updateImage(imgId, isOver) {
       var theImage = document.getElementById(imgId);
       if (theImage != null) {
         if (isOver) {
           theImage.setAttribute("src","yellowplus.gif");
         }
         else {
           theImage.setAttribute("src","greyplus.gif");
         }
       }
     }
    </script>
  </head>
  <body>
    <p>Mouse over or tab to the links below and see the image change.</p>
    <a href="https://www.w3.org/WAI/"
       onmouseover="updateImage('wai', true);" onfocus="updateImage('wai', true);"
       onmouseout="updateImage('wai',false);" onblur="updateImage('wai',false);">
       <img alt="" id="wai" src="greyplus.gif">
       W3C Web Accessibility Initiative</a> &amp;
    <a href="https://www.w3.org/International/" onmouseover="updateImage('i18n', true);" 
       onfocus="updateImage('i18n',true);" onmouseout="updateImage('i18n',false);"
       onblur="updateImage('i18n',false);">
       <img alt="" id="i18n" src="greyplus.gif">
       W3C Internationalization</a>
  </body>
</html>

Probak

Prozedura

Kargatu web-orria eta probatu gertaerak saguarekin eta teklatuarekin.

  1. Egiaztatu irudi «estandarra» espero bezala erakusten dela web-orria kargatzean.
  2. Saguarekin:

    1. Mugitu sagua gertaera-kudeatzaileak dituen elementuaren gainera (adibide honetan, aingura-elementu bat da). Egiaztatu irudia espero den irudira aldatzen dela.
    2. Urrundu sagua elementutik. Egiaztatu irudia berriro irudi «estandarra» dela.
  3. Teklatuarekin:

    1. Erabili teklatua fokua gertaera-kudeatzaileak dituen elementuan jartzeko. Egiaztatu irudia espero den irudira aldatzen dela.
    2. Erabili teklatua fokua elementutik kentzeko (normalean, fokua beste elementu batera eramanez). Egiaztatu irudia berriro irudi «estandarra» dela.
  4. Egiaztatu orriko gainerako elementuen diseinuari ez diola eragiten irudia aldatzeak.

Espero diren emaitzak

  • Aurreko egiaztapenetako urrats guztiak egiazkoak dira.

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