Addaw, joan hasierara Egin dohaintza

Teknika Bezero-scriptak WCAG 2.2

SCR39Sagua gainean jartzean edo fokua jasotzean agertzen den edukia irakurgarri eta itxigarri egitea

Izen ofiziala W3Cn: Erakuslea gainean jartzean edo fokua jasotzean agertzen den edukiaren gainean erakuslea jarri ahal izatea, edukia baztergarria izatea eta iraunkorra izatea

Versión en castellano · Versió en català

Laburbilduz

Sagua gainean jartzean edo teklatuarekin iristean agertzen diren leiho gainerakorrek, laguntza-baloiek eta aurrebistek hiru baldintza bete behar dituzte. Haien gainean erakuslea mugitu ahal izan behar da, desagertu gabe. Ez dira berez itxi behar. Eta Esc teklarekin itxi ahal izan behar dira, sagua edo fokua mugitu gabe.

Zergatik da garrantzitsua

Pantaila-handigailu bat (pantailaren zati bat handitzen duen programa) erabiltzen duen ikusmen urriko pertsona batek zati bat baino ez du ikusten aldi bakoitzean. Laguntza-baloi bat irakurtzeko, sagua haraino eraman behar du. Baloia botoitik irtetean desagertzen bada, ezin du irakurri.

  • Edukia segundo batzuen buruan berez ixten bada, poliki irakurtzen duenak erdizka utzi beharko du.
  • Orriaren beste zati bat estaltzen badu, adibidez aurretiko hitzorduko formulario bateko eremu bat, posizioa galdu gabe itxi ahal izan behar da.

Nola egiten da

  1. Jarri edukia aktibatzen duen elementua eta eduki gainerakorra edukiontzi berean. Erakutsi edukia erakuslea bietako edozeinen gainean dagoen bitartean.
  2. Saihestu tarteak aktibatzailearen eta eduki gainerakorraren artean, erakusleak bitartea zeharkatzean edukia itxi ez dezan.
  3. Ez erabili tenporizadorerik edukia ezkutatzeko. Ikusgai egon behar du pertsona joan arte edo hark itxi arte.
  4. Eman Esc teklarekin ixteko aukera, sagua edo fokua (idazten dena jasotzen duen elementua) mugitu gabe.
  5. Erakutsi edukia aktibatzaileak teklatuarekin fokua jasotzen duenean ere, ez saguarekin soilik.

Nola egiaztatu

  1. Pasatu sagua aktibatzailearen gainetik eta eraman poliki eduki gainerakorreraino. Ez du desagertu behar.
  2. Utzi sagua geldi denbora luze batez. Edukiak ikusgai jarraitu behar du.
  3. Sagua oraindik gainean dagoela, sakatu Esc. Edukia itxi egin behar da.
  4. Iritsi aktibatzaileraino tabulazio-teklarekin. Edukiak agertu egin behar du, ikusgai geratu, eta Esc teklarekin itxi, fokua galdu gabe.

Adibidea

Laguntza-baloi baterako scripta: baloiak ikusgai jarraitzen du erakuslea haren gainean dagoenean, eta Esc teklarekin ixten da.

// Edukiontziak botoia eta laguntza-baloia ditu barnean
const caja = document.querySelector('.ayuda');
const globo = caja.querySelector('[role="tooltip"]');
const mostrar = () => { globo.hidden = false; };
const ocultar = () => { globo.hidden = true; };

caja.addEventListener('mouseenter', mostrar);
caja.addEventListener('mouseleave', ocultar); // ikusgai jarraitzen du baloiaren gainean
caja.addEventListener('focusin', mostrar);
caja.addEventListener('focusout', ocultar);
document.addEventListener('keydown', (e) => {
  if (e.key === 'Escape') ocultar(); // sagua edo fokua mugitu gabe ixten da
});
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

Teknika hau erakuslea gainean jartzean eduki gehigarria erakusteko aukera ematen duen edozein teknologiari aplika dakioke.

Deskribapena

Erabiltzaileak erakuslea elementu aktibatzaile baten gainera mugitzen duenean edo teklatuaren fokua aktibatzaile horretara eramaten duenean erakusten den eduki gehigarriak (adibidez, leiho gainerakor batek) ikusgai jarraitu behar du, erabiltzaileei hura irakurtzeko eta harekin elkarreragiteko denbora emateko, eta erabiltzaileari erakuslea eduki gehigarriaren gainera mugitzeko aukera eman behar dio.

Pantaila handitzen duten ikusmen urriko pertsonek, askotan, pantailaren zati txiki bat baino ez dute ikusten aldi berean (beren ikuspegi-eremua). Horrek esan nahi du eduki gehigarria agian ez dela osorik ikusten uneko ikuspegi-eremuan, eta erabiltzaileek agian sagua eduki gehigarriaren gainera mugitu beharko dutela hura irakurtzeko. Horregatik, web-garatzaileek ziurtatu behar dute eduki gehigarriak ikusgai jarraitzen duela erakuslea aktibatzailetik eduki gehigarrira (normalean, ondoan dagoena) mugitzen denean. Eduki gehigarria fokua mugitu gabe baztertu ahal izan behar da, erabiltzaileek eduki gehigarriak estaltzen duen edukia irakurri ahal izan dezaten.

Adibideak

Esteken edukiaren aurrebista

Erakuslea esteka baten gainean jartzean edo esteka fokuratzean, estekaren edukiaren aurrebista bat agertzen da haren gainean edo azpian. Erabiltzaileek erakuslea eduki gehigarriaren (leiho gainerakorraren) gainera mugi dezakete, osorik irakurri ahal izateko. Esc tekla sakatzean, eduki gehigarria baztertu (itxi) egiten da.

1. adibidearen HTML kodea

<p>This is the
   <a class="a-and-tooltip" id="parent" href="index.html">trigger
   <span id="popup" role="tooltip">And this additional text
    gives additional context on the trigger term
   </span>
  </a>.
   Text and popup are <strong>in one link (a)</strong> element.
</p>

1. adibidearen CSS kodea

[role="tooltip"] {
  display: none;
  padding: 0.5em;
  background:white;
  color: black;
  border:solid black 2px;
  width:10em;
}
.a-and-tooltip {
  position: relative;
}
[role="tooltip"] {
  position: absolute;
  left:0;
  top:1em;
}

1. adibidearen JavaScript kodea

// trigger and popup inside the same link
var parent = document.getElementById("parent");
parent.onmouseover = function() {
  document.getElementById("popup").style.display = "block";
}
parent.onmouseout = function() {
  document.getElementById("popup").style.display = "none";
}
parent.onfocus = function() {
  document.getElementById("popup").style.display = "block";
}
parent.onblur = function() {
  document.getElementById("popup").style.display = "none";
}
// hide when ESC is pressed
document.addEventListener("keydown", (e) => {
  if ((e.keyCode || e.which) === 27)
    document.getElementById("popup").style.display = "none";
});

Erakuslea gainean jartzean edo fokua jasotzean agertzen den edukiaren adibide funtzionala

Probak

Prozedura

Erakuslea gainean jartzean agertzen den eduki gehigarriari dagokionez, egiaztatu:

  1. Erakuslea eduki gehigarriaren gainera mugi daitekeela, hura desagertu gabe.
  2. Eduki gehigarriak ikusgai jarraitzen duela eta ez dela automatikoki ixten denbora jakin baten buruan.
  3. Edukia itxi daitekeela erakuslea aktibatzailetik aldendu gabe, Esc sakatuz, dokumentatutako beste laster-tekla bat sakatuz edo aktibatzailea bera aktibatuz.

Fokua jasotzean agertzen den eduki gehigarriari dagokionez, egiaztatu:

  1. Eduki gehigarriak ikusgai jarraitzen duela eta ez dela automatikoki ixten denbora jakin baten buruan.
  2. Edukia itxi daitekeela fokua aktibatzailetik aldendu gabe, Esc sakatuz, dokumentatutako beste laster-tekla bat sakatuz edo aktibatzailea bera aktibatuz.

Espero diren emaitzak

Erakuslea gainean jartzean agertzen den edukiari dagokionez:

  • 1., 2. eta 3. egiaztapenak egiazkoak dira.

Fokua jasotzean agertzen den edukiari dagokionez:

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