Tècnica Scripts de client WCAG 2.2
SCR28Permetre plegar els menús que es repeteixen a cada pàgina
Nom oficial al W3C: Utilitzar un menú expandible i contraïble per evitar blocs de contingut
En poques paraules
Els menús llargs que es repeteixen a totes les pàgines poden portar un botó per plegar-los i desplegar-los. Quan es pleguen, els seus enllaços deixen de rebre el focus i el lector de pantalla no els llegeix. Així la persona se salta aquest bloc i arriba abans al contingut principal.
Per què és important
Qui navega amb teclat ha de prémer Tab a cada enllaç del menú abans d'arribar al contingut. En un menú de 40 enllaços, això li passa a cada pàgina que visita.
El lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) també llegeix el mateix menú una vegada i una altra. Un menú plegable permet saltar-lo amb una sola pulsació.
Com es fa
- Poseu un botó (
<button>) just abans del bloc repetit, amb un text clar com «Índex de la guia». - Indiqueu-ne l'estat amb
aria-expanded="true"o"false". Relacioneu el botó amb el bloc mitjançantaria-controls. - En plegar-lo, amagueu el bloc de debò amb l'atribut
hiddeno ambdisplay: none. Així els seus enllaços no reben el focus ni es llegeixen. - En desplegar-lo, el contingut ha d'aparèixer just després del botó, en un ordre de lectura lògic.
- Valoreu recordar la preferència de la persona entre pàgines, per exemple amb
localStorage. - Aquesta tècnica es pot combinar amb un enllaç «Salta al contingut principal».
Com comprovar-ho
- Busqueu el control que plega i desplega el bloc repetit. S'hi ha de poder arribar amb Tab i s'ha de poder activar amb Retorn o Espai.
- Plegueu el bloc i premeu Tab. El focus no ha de passar per cap dels seus enllaços.
- Amb un lector de pantalla, comproveu que el bloc plegat no es llegeix i que el botó s'anuncia com a «contret».
- Desplegueu el bloc i comproveu que els seus enllaços apareixen just després del botó.
Exemple
Índex d'una guia que es repeteix a cada pàgina i es plega amb un botó.
<button type="button" aria-expanded="true" aria-controls="indice">
Índex de la guia
</button>
<ul id="indice">
<li><a href="/guia/requisitos">Requisits</a></li>
<li><a href="/guia/plazos">Terminis</a></li>
</ul>
<script>
var boton = document.querySelector('[aria-controls="indice"]');
boton.addEventListener('click', function () {
var abierto = boton.getAttribute('aria-expanded') === 'true';
boton.setAttribute('aria-expanded', String(!abierto));
document.getElementById('indice').hidden = abierto;
});
</script>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR28 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 proporcionen scripts al costat del client.
Descripció
Aquesta tècnica permet als usuaris saltar-se el material repetit col·locant-lo en un menú que es pot expandir o contraure sota el control de l'usuari. L'usuari es pot saltar el material repetit contraient el menú. L'usuari acciona un control de la interfície d'usuari per amagar o eliminar els elements del menú. La secció de recursos enumera diverses tècniques per a menús, barres d'eines i arbres, qualsevol de les quals es pot utilitzar per proporcionar un mecanisme que permeti saltar la navegació.
Es poden implementar enfocaments similars utilitzant scripts al costat del servidor i recarregant una versió modificada de la pàgina web.
Exemples
Mostrar i amagar un índex de continguts
L'índex de continguts d'un conjunt de pàgines web es repeteix a prop del principi de cada pàgina web. Un botó situat al principi de l'índex permet a l'usuari eliminar-lo de la pàgina o restaurar-lo.
...
<script>
let tocToggle = document.querySelector(".toc-toggle");
let toc = document.querySelector("#toc");
tocToggle.addEventListener("click", toggle, false);
function toggle(e){
let elm = e.currentTarget;
if(elm.getAttribute("aria-expanded") === "false"){
elm.setAttribute("aria-expanded", "true");
}
else{
elm.setAttribute("aria-expanded", "false");
}
}
</script>
...
<button aria-controls="toc" aria-expanded="true" class="toc-toggle" type="button">
Toggle Table Of Contents
</button>
<nav aria-labelledby="toc-header" id="toc">
<h2 id="toc-header">Table of Contents</h2>
<ul>
<li><a href="#sec1">Section 1</a></li>
<li><a href="#sec2">Section 2</a></li>
<li><a href="#sec3">Section 3</a></li>
<li><a href="#sec4">Section 4</a></li>
</ul>
</nav>
...
Exemple pràctic d'aquest codi: Mostrar i amagar un índex de continguts amb un botó.
Proves
Procediment
- Comprovar que algun control de la interfície d'usuari permet expandir o contraure el contingut repetit.
- Comprovar que, quan el contingut està expandit, s'inclou en el contingut determinable per programari en un lloc lògic de l'ordre de lectura.
- Comprovar que, quan el contingut està contret, no forma part del contingut determinable per programari.
Resultats esperats
- Totes les comprovacions anteriors són certes.
Recursos
- ARIA - Disclosure (Show/Hide) pattern. (patró Disclosure, mostrar/amagar, de les pràctiques d'autoria d'ARIA)
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.
Basat en la tècnica SCR28 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.