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

Tècnica Scripts de client WCAG 2.2

SCR27Reordenar blocs de la pàgina amb opcions de menú, no només arrossegant

Nom oficial al W3C: Reordenar seccions de la pàgina mitjançant el Document Object Model

Versión en castellano

En poques paraules

Si una pàgina permet canviar l'ordre dels seus blocs arrossegant-los amb el ratolí, també ha d'oferir opcions com «Puja» i «Baixa» a cada bloc. Aquestes opcions funcionen amb teclat. A més, l'script ha de canviar l'ordre real al codi, no només la posició a la pantalla.

Per què és important

Arrossegar i deixar anar exigeix un ratolí o un dit amb bon control. Qui fa servir només el teclat, un lector de pantalla o un polsador no pot arrossegar.

Per exemple, en una intranet amb mòduls d'«Agenda», «Notícies» i «Avisos», aquestes persones no podrien personalitzar el seu tauler. I si el canvi només és visual, l'ordre de lectura i de tabulació ja no coincideix amb el que es veu.

Com es fa

  1. Afegiu a cada bloc que es pot moure un petit menú amb opcions com «Puja» i «Baixa». Si la graella té columnes, afegiu-hi també «Esquerra» i «Dreta».
  2. Utilitzeu botons o enllaços per a aquestes opcions i llanceu l'script des de l'esdeveniment click.
  3. Col·loqueu aquest menú dins del mateix bloc al codi, al costat del que mou.
  4. Moveu el bloc al DOM (l'estructura de la pàgina que el navegador crea a partir de l'HTML), per exemple amb insertBefore. No el recol·loqueu només amb CSS.
  5. Després de moure'l, torneu el focus a l'opció premuda. Així la persona pot continuar movent-lo sense perdre's.
  6. Doneu a cada opció un nom clar, com «Puja el bloc Notícies».

Com comprovar-ho

  1. Localitzeu els blocs que es poden arrossegar.
  2. Comproveu que cadascun té opcions per moure'l que s'assoleixen amb Tab i s'activen amb Retorn.
  3. Moveu un bloc amb el teclat. El focus ha de continuar a l'opció utilitzada.
  4. Recorreu la pàgina amb Tab o amb el lector de pantalla. L'ordre ha de coincidir amb el nou ordre a la pantalla.
  5. A les eines del navegador (F12), comproveu que el bloc ha canviat de lloc al codi.

Exemple

Cada mòdul d'una llista porta un botó «Puja» que el mou de debò al codi.

<li class="modulo">
  <h2>Notícies</h2>
  <button type="button" class="subir">Puja el bloc Notícies</button>
</li>
<script>
document.querySelectorAll('.subir').forEach(function (boton) {
  boton.addEventListener('click', function () {
    var modulo = boton.closest('.modulo');
    var anterior = modulo.previousElementSibling;
    if (anterior) modulo.parentNode.insertBefore(modulo, anterior);
    boton.focus(); // el focus continua al botó premut
  });
});
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR27 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

HTML, scripts

Descripció

L'objectiu d'aquesta tècnica és proporcionar un mecanisme per reordenar components que sigui alhora molt usable i accessible. Els dos mecanismes més habituals per reordenar són enviar els usuaris a una pàgina de configuració en què poden numerar els components, o permetre'ls arrossegar i deixar anar els components fins a la posició desitjada. El mètode d'arrossegar i deixar anar és molt més usable, ja que permet a l'usuari col·locar els elements al seu lloc, d'un en un, i fer-se una idea del resultat. Malauradament, arrossegar i deixar anar depèn de l'ús del ratolí. Aquesta tècnica permet als usuaris interactuar amb un menú situat als components per reordenar-los al seu lloc de manera independent del dispositiu. Es pot utilitzar en lloc de la funcionalitat de reordenació mitjançant arrossegar i deixar anar, o juntament amb aquesta.

El menú és una llista d'enllaços que utilitza l'esdeveniment onclick, independent del dispositiu, per desencadenar els scripts que reordenen el contingut. El contingut es reordena al Document Object Model (DOM), no només visualment, de manera que quedi en l'ordre correcte per a tots els dispositius.

Exemples

Aquest exemple reordena cap amunt i cap avall. Aquest enfocament també es pot utilitzar per a una reordenació bidimensional afegint-hi les opcions esquerra i dreta.

Els components d'aquest exemple són elements d'una llista no ordenada. Les llistes no ordenades són un model semàntic molt adequat per a conjunts d'elements similars, com aquests components. L'enfocament del menú també es pot utilitzar per a altres tipus d'agrupacions.

Els mòduls són elements de llista, i cada mòdul, a més del contingut en elements div, conté un menú representat com una llista niada.

<ul id="swapper">
    <li id="black">
      <div class="module">
        <div class="module_header">
          <!-- menu link -->
          <a href="#" onclick="ToggleMenu(event);">menu</a>
          <!-- menu -->
          <ul class="menu">
            <li><a href="#" onclick="OnMenuClick(event)" 
              onkeypress="OnMenuKeypress(event);">up</a></li>
            <li><a href="#" onclick="OnMenuClick(event)" 
              onkeypress="OnMenuKeypress(event);">down</a></li>
          </ul>
        </div>
      <div class="module_body">
        Text in the black module
      </div>
    </div>
  </li>
  ...
</ul>

Com que ja hem tractat com mostrar i amagar menús als exemples de l'arbre senzill, aquí ens centrarem únicament en el codi que intercanvia els mòduls. Un cop harmonitzem els esdeveniments i cancel·lem l'acció predeterminada de l'enllaç, ens posem a treballar. Primer, definim una sèrie de variables locals per als elements amb què treballarem: el menú, el mòdul que es reordenarà i l'enllaç del menú (menuLink). Després, un cop comprovada la direcció de la reordenació, intentem obtenir el node amb què fer l'intercanvi. Si el trobem, cridem swapNode() per intercanviar els nostres dos mòduls i PositionElement() per moure el menú, posicionat de manera absoluta, juntament amb el mòdul, i a continuació tornem el focus a l'element del menú que ho ha posat tot en marxa.

function MoveNode(evt,dir){
  HarmonizeEvent(evt);
  evt.preventDefault();
  var src = evt.target;
  var menu = src.parentNode.parentNode;
  var module = menu.parentNode.parentNode.parentNode;
  var menuLink = module.getElementsByTagName("a")[0];
  var swap = null;
  switch(dir){
    case 'up': {
      swap = module.previousSibling;
      while (swap && swap.nodeType != 1){
        swap = swap.previousSibling;
      }
        break;
    }
    case 'down': {
      swap = module.nextSibling;
      while (swap && swap.nodeType != 1){
        swap = swap.nextSibling;
      }
        break;
    }
  }
  if (swap && swap.tagName == node.tagName){
    module.swapNode(swap);
    PositionElement(menu,menuLink,false,true);
  }
  src.focus();
}

El CSS per a l'intercanvi de nodes no difereix gaire del dels nostres exemples anteriors de l'arbre, amb alguns ajustos de mida i color per als mòduls i el petit menú.

ul#swapper {
  list-item-style:none;
  margin:0px;
  padding:0px;
}
ul#swapper li {
  border:1px solid black;
  height:5em;
  list-style:none;
  margin:1em;
  padding:0;
  width:15em;
}
ul#swapper li a {
  color:white;
  font-size:90%;
  text-decoration:none;
}
ul#swapper li div.module_header {
  padding:0 0.2em;
  text-align:right;
}
ul#swapper li div.module_body {
  padding:0.2em;
}
ul#swapper ul.menu {
  background-color:#eeeeee; 
  border:1px solid gray;
  display:none;
  height:auto;
  list-style:none;
  margin:0;
  padding:0;
  position:absolute;
  text-align:left;
}
ul#swapper ul.menu li {
  border:none;
  font-weight:normal;
  height:auto;
  margin:0;
  text-align:left;
  width:5em;
}
ul#swapper ul.menu li a {
  color:black;
  display:block;
  padding:0 0.1em;
  text-decoration:none;
  width:100%;
}

Proves

Procediment

  1. Localitzar tots els components que es poden reordenar mitjançant arrossegar i deixar anar.
  2. Comprovar que també hi ha un mecanisme per reordenar-los mitjançant menús construïts amb llistes d'enllaços.
  3. Comprovar que els menús estan continguts dins dels elements reordenables al DOM.
  4. Comprovar que els scripts de reordenació es desencadenen únicament des de l'esdeveniment onclick dels enllaços.
  5. Comprovar que els elements es reordenen al DOM, no només visualment.

Resultats esperats

  • Les comprovacions núm. 2 a núm. 5 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 SCR27 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.