Addaw, anar a la pàgina d'inici Donar

Tècnica Scripts de client WCAG 2.2

SCR33Oferir un botó per posar en pausa el text que es desplaça amb JavaScript

Nom oficial al W3C: Utilitzar scripts per desplaçar el contingut i proporcionar un mecanisme per posar-lo en pausa

Versión en castellano

En poques paraules

Si un script mou text per la pantalla, com ara un teletip de notícies o una franja d'avisos, la pàgina ha d'oferir un control per posar-lo en pausa i un altre per reprendre'l. En reprendre'l, el moviment continua des d'on s'havia aturat. Així cada persona llegeix al seu ritme i el moviment deixa de distreure.

Per què és important

El text en moviment és difícil de llegir per a persones amb baixa visió, amb dislèxia o que llegeixen a poc a poc. Quan aconsegueixen fixar-se en una frase, ja ha desaparegut.

El moviment també distreu. Qui té dificultats d'atenció no aconsegueix concentrar-se en la resta de la pàgina mentre alguna cosa es mou al costat.

Com es fa

  1. Poseu al costat del text en moviment un botó visible «Pausa». S'hi ha de poder arribar amb Tab i s'ha de poder activar amb Retorn o Espai.
  2. Quan es premi, atureu el temporitzador o l'animació. El text no s'ha de tornar a moure sol.
  3. Canvieu el text del botó a «Reprèn». Quan es premi, continueu des de la mateixa posició.
  4. Si no hi ha JavaScript o CSS, mostreu el text complet i quiet, i amagueu el botó.
  5. Valoreu començar en pausa si la persona ha demanat reduir el moviment al seu sistema (prefers-reduced-motion).

Com comprovar-ho

  1. Localitzeu cada zona amb text en moviment i busqueu-ne el control de pausa.
  2. Premeu «Pausa» amb el teclat. El text s'ha d'aturar.
  3. Espereu uns segons i comproveu que no es torna a moure per si sol.
  4. Premeu «Reprèn» i comproveu que continua des d'on s'havia aturat.

Exemple

Franja d'avisos que es desplaça amb un script i un botó que la posa en pausa i la reprèn.

<p id="avisos" style="overflow: hidden; white-space: nowrap">Tall d'aigua al barri del Carmen dilluns de 8.00 a 12.00.</p>
<button type="button" id="pausa">Pausa</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 ? 'Reprèn' : 'Pausa';
});
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR33 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Tecnologies que permeten desplaçar el contingut mitjançant scripts.

Descripció

L'objectiu d'aquesta tècnica és proporcionar als usuaris una manera d'aturar el contingut en desplaçament quan aquest desplaçament el genera un script. El contingut que es desplaça pot ser difícil o impossible de llegir per als usuaris amb baixa visió o amb discapacitats cognitives. El moviment també pot distreure algunes persones i dificultar-los la concentració en altres parts de la pàgina web.

Exemples

En aquest exemple s'utilitzen CSS i JavaScript per presentar visualment un text en format de desplaçament. S'inclou un enllaç per posar en pausa el moviment de desplaçament.

Aquesta implementació mostrarà el text complet i ometrà l'enllaç quan JavaScript o CSS no siguin compatibles o estiguin desactivats.

El component HTML

...
<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>
...

El component CSS

...
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;
}
...

El component JavaScript

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)

Hi ha disponible un exemple funcional d'aquest codi: Example of using script to scroll content and providing a mechanism to pause it (exemple d'ús d'scripts per desplaçar contingut amb un mecanisme per posar-lo en pausa).

Proves

Procediment

  1. Comprovar que es proporciona un mecanisme per posar en pausa el contingut en desplaçament.
  2. Utilitzar el mecanisme de pausa per posar en pausa el contingut en desplaçament.
  3. Comprovar que el desplaçament s'ha aturat i no es reinicia per si sol.
  4. Comprovar que es proporciona un mecanisme per reprendre el contingut en pausa.
  5. Utilitzar el mecanisme de represa proporcionat per reprendre el contingut en desplaçament.
  6. Comprovar que el desplaçament s'ha reprès des del punt en què s'havia aturat.

Resultats esperats

  • Les comprovacions núm. 3 i núm. 6 són certes.

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica SCR33 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.