Addaw, joan hasierara Egin dohaintza

Teknika Bezero-scriptak WCAG 2.2

SCR33JavaScript bidez desplazatzen den testua pausatzeko botoi bat eskaintzea

Izen ofiziala W3Cn: Scriptak erabiltzea edukia desplazatzeko eta hura pausatzeko mekanismo bat ematea

Versión en castellano · Versió en català

Laburbilduz

Script batek testua pantailan zehar mugitzen badu, albiste-zinta edo abisu-zerrenda bat, adibidez, orriak kontrol bat eskaini behar du hura pausatzeko, eta beste bat berriro abiarazteko. Berriro abiaraztean, mugimenduak gelditu zen lekutik jarraitzen du. Horrela, pertsona bakoitzak bere erritmoan irakurtzen du, eta mugimenduak distraitzeari uzten dio.

Zergatik da garrantzitsua

Mugitzen den testua irakurtzeko zaila da ikusmen urria edo dislexia duten pertsonentzat edo astiro irakurtzen dutenentzat. Esaldi batean arreta jartzea lortzen dutenerako, desagertu egin da jada.

Mugimenduak distraitu ere egiten du. Arreta-zailtasunak dituenak ez du lortzen orriaren gainerakoan kontzentratzea ondoan zerbait mugitzen ari den bitartean.

Nola egiten da

  1. Jarri mugitzen den testuaren ondoan «Pausatu» botoi ikusgarri bat. Tab teklarekin iritsi behar da hara, eta Sartu teklarekin edo Zuriune-barrarekin aktibatu.
  2. Sakatzean, gelditu tenporizadorea edo animazioa. Testuak ez du berriro bere kabuz mugitu behar.
  3. Aldatu botoiaren testua eta jarri «Berrabiarazi». Sakatzean, jarraitu posizio beretik.
  4. JavaScript edo CSS ez badago, erakutsi testu osoa eta geldirik, eta ezkutatu botoia.
  5. Aztertu pausatuta hastea komeni den, pertsonak bere sisteman mugimendua murrizteko eskatu badu (prefers-reduced-motion).

Nola egiaztatu

  1. Aurkitu mugitzen den testua duen gune bakoitza eta bilatu haren pausa-kontrola.
  2. Sakatu «Pausatu» teklatuarekin. Testuak gelditu egin behar du.
  3. Itxaron segundo batzuk eta egiaztatu ez dela berriro bere kabuz mugitzen.
  4. Sakatu «Berrabiarazi» eta egiaztatu gelditu zen lekutik jarraitzen duela.

Adibidea

Script batekin desplazatzen den abisu-zerrenda bat eta hura pausatu eta berriro abiarazten duen botoi bat.

<p id="avisos" style="overflow: hidden; white-space: nowrap">Ur-mozketa Carmen auzoan astelehenean, 8:00etatik 12:00etara.</p>
<button type="button" id="pausa">Pausatu</button>
<script>
var pos = 0, parado = false, avisos = document.getElementById('avisos');
setInterval(function () {
  if (parado) return;
  pos = (pos + 1) % 300;
  avisos.style.textIndent = -pos + 'px';
}, 50);
document.getElementById('pausa').addEventListener('click', function () {
  parado = !parado;
  this.textContent = parado ? 'Berrabiarazi' : 'Pausatu';
});
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

Edukia scripten bidez desplazatzeko aukera ematen duten teknologiak.

Deskribapena

Teknika honen helburua da erabiltzaileei desplazatzen ari den edukia gelditzeko modu bat ematea, desplazamendu hori script batek sortzen duenean. Desplazatzen den edukia zaila edo ezinezkoa izan daiteke irakurtzeko ikusmen urria edo desgaitasun kognitiboak dituzten erabiltzaileentzat. Mugimenduak pertsona batzuk distraitu ere egin ditzake, eta web-orriaren beste atal batzuetan kontzentratzea zaildu.

Adibideak

Adibide honetan, CSS eta JavaScript erabiltzen dira testu bat bisualki desplazamendu-formatuan aurkezteko. Desplazamendu-mugimendua pausatzeko esteka bat sartzen da.

Inplementazio honek testu osoa erakutsiko du eta esteka ezabatuko du JavaScript edo CSS bateragarriak ez direnean edo desaktibatuta daudenean.

HTML osagaia

...
<div id="scroller">
  <p id="tag">This text will scroll and a Pause/Scroll link will be present 
  when JavaScript and CSS are supported and active.</p>
</div>
...

CSS osagaia

...
body {
  font:1em verdana,sans-serif;
  color:#000;
  margin:0
}
#scroller {
  position:relative;
  overflow:hidden;
  width:15em;
  border:1px solid #008080;
}
#tag {
  margin:2px 0;
}
#testP {
  visibility:hidden;
  position:absolute;
  white-space:nowrap;
} 
 #top {
  width:350px;
  margin:auto;
}
...

JavaScript osagaia

var speed=50        // speed of scroller
var step=3          // smoothness of movement
var StartActionText= "Scroll"  // Text for start link
var StopActionText = "Pause"   // Text for stop link
var x, scroll, divW, sText=""
function onclickIE(idAttr,handler,call){
  if ((document.all)&&(document.getElementById)){idAttr[handler]="Javascript:"+call}
}
function addLink(id,call,txt){
  var e=document.createElement('a');
  e.setAttribute('href',call);
  var linktext=document.createTextNode(txt);
  e.appendChild(linktext);
  document.getElementById(id).appendChild(e);
}
function getElementStyle() {
  var elem = document.getElementById('scroller');
  if (elem.currentStyle) {
    return elem.currentStyle.overflow;
  }
  else if (window.getComputedStyle) {
    var compStyle = window.getComputedStyle(elem, '');
    return compStyle.getPropertyValue("overflow");
  }
  return "";
}
function addControls(){
  // test for CSS support first 
  // test for the overlow property value set in style element or external file
  if (getElementStyle()=="hidden") {
    var f=document.createElement('div');
    f.setAttribute('id','controls');
    document.getElementById('scroller').parentNode.appendChild(f);
    addLink('controls','Javascript:clickAction(0)',StopActionText);
    onclickIE(document.getElementById('controls').childNodes[0],"href",'clickAction(0)');
    document.getElementById('controls').style.display='block';
  }
}
function stopScroller(){clearTimeout(scroll)}
function setAction(callvalue,txt){
  var c=document.getElementById('controls')
  c.childNodes[0].setAttribute('href','Javascript:clickAction('+callvalue+')')
    onclickIE(document.getElementById('controls').childNodes[0],"href",'clickAction
  ('+callvalue+')')
  c.childNodes[0].firstChild.nodeValue=txt
}
function clickAction(no){
  switch(no) {
    case 0:
      stopScroller();
      setAction(1,StartActionText);
      break;
    case 1:
      startScroller();
      setAction(0,StopActionText);
  }
}
function startScroller(){
  document.getElementById('tag').style.whiteSpace='nowrap'
  var p=document.createElement('p')
  p.id='testP'
  p.style.fontSize='25%' //fix for mozilla. multiply by 4 before using
  x-=step
  if (document.getElementById('tag').className) p.className=document.getElementById
  ('tag').className
    p.appendChild(document.createTextNode(sText))
    document.body.appendChild(p)
    pw=p.offsetWidth
    document.body.removeChild(p)
    if (x<(pw*4)*-1){x=divW}
    document.getElementById('tag').style.left=x+'px'
    scroll=setTimeout('startScroller()',speed)
}
function initScroller(){
  if (document.getElementById && document.createElement && document.body.appendChild) {
    addControls();
    divW=document.getElementById('scroller').offsetWidth;
    x=divW;
    document.getElementById('tag').style.position='relative';
    document.getElementById('tag').style.left=divW+'px';
    var ss=document.getElementById('tag').childNodes;
    for (i=0;i<ss.length;i++) {sText+=ss[i].nodeValue+" "};
    scroll=setTimeout('startScroller()',speed);
  }
}
function addLoadEvent(func) {
  if (!document.getElementById | !document.getElementsByTagName) return
  var oldonload = window.onload
  if (typeof window.onload != 'function') {
    window.onload = func;
  } else {
    window.onload = function() {
      oldonload()
      func()
    }
  }
}
addLoadEvent(initScroller)

Kode honen adibide funtzional bat dago eskuragarri: Example of using script to scroll content and providing a mechanism to pause it (edukia desplazatzeko scriptak erabiltzearen adibidea, hura pausatzeko mekanismo batekin).

Probak

Prozedura

  1. Egiaztatzea desplazatzen ari den edukia pausatzeko mekanismo bat ematen dela.
  2. Pausa-mekanismoa erabiltzea desplazatzen ari den edukia pausatzeko.
  3. Egiaztatzea desplazamendua gelditu egin dela eta ez dela berriro bere kabuz abiarazten.
  4. Egiaztatzea pausatutako edukia berriro abiarazteko mekanismo bat ematen dela.
  5. Emandako berrabiarazte-mekanismoa erabiltzea desplazatzen ari zen edukia berriro abiarazteko.
  6. Egiaztatzea desplazamendua gelditu zen puntutik berrabiarazi dela.

Espero diren emaitzak

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