Tècnica Scripts de client WCAG 2.2
SCR30Oferir un control que completi el text dels enllaços a petició
Nom oficial al W3C: Utilitzar scripts per canviar el text dels enllaços
En poques paraules
Alguns enllaços només s'entenen pel que els envolta, com ara diversos «Més informació» en una llista de notícies. Aquesta tècnica posa al principi de la pàgina un control que, quan s'activa, completa amb JavaScript el text d'aquests enllaços. Així cada persona tria entre enllaços curts o enllaços que s'entenen sols.
Per què és important
Moltes persones que fan servir un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) consulten una llista amb tots els enllaços de la pàgina. En aquesta llista, deu «Més informació» no diuen res.
Altres persones prefereixen textos curts, perquè sentir el context a cada enllaç els resulta repetitiu. Amb aquesta tècnica, cadascú tria l'opció que li resulta més còmoda.
Com es fa
- Col·loqueu a prop del principi de la pàgina un botó o enllaç amb un text que s'entengui sol, com «Mostra els enllaços amb el text complet».
- Marqueu els enllaços que necessiten context. Per exemple, amb un atribut
data-que guardi el text que falta. - En activar el control, l'script afegeix aquest text dins de cada enllaç. «Més informació» passa a ser «Més informació sobre els ajuts al lloguer».
- Permeteu tornar a la versió curta amb el mateix control.
- Si és possible, recordeu l'elecció amb una galeta o al perfil de la persona. Així no l'haurà de repetir a cada pàgina.
Com comprovar-ho
- Comproveu que a prop del principi de la pàgina hi ha un control per ampliar els enllaços i que el seu text s'entén sol.
- Anoteu els enllaços la destinació dels quals no s'entén sense llegir el que els envolta.
- Activeu el control.
- Reviseu de nou aquests enllaços. Ara el seu text, per si sol, ha d'explicar on porten. La llista d'enllaços del lector de pantalla ajuda a veure-ho (a NVDA, Insert + F7).
Exemple
Un botó afegeix a cada «Més informació» el text que n'explica la destinació.
<button type="button" id="ampliar">Mostra els enllaços amb el text complet</button>
<h2>Ajuts al lloguer</h2>
<p>Termini obert fins al 30 de novembre.
<a href="/ayudas-alquiler" data-extra=" sobre els ajuts al lloguer">Més informació</a></p>
<script>
document.getElementById('ampliar').addEventListener('click', function () {
document.querySelectorAll('a[data-extra]').forEach(function (enlace) {
enlace.textContent += enlace.dataset.extra;
});
}, { once: true });
</script>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR30 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
Scripts del costat del client utilitzats amb HTML
Descripció
El propòsit d'aquesta tècnica és permetre que els usuaris triïn que s'afegeixi informació addicional al text dels enllaços, de manera que els enllaços es puguin entendre fora de context.
Alguns usuaris prefereixen enllaços autònoms, en què no calgui explorar el context de l'enllaç. Altres usuaris consideren que incloure la informació de context a cada enllaç resulta repetitiu i redueix la seva capacitat d'utilitzar el lloc. Entre els usuaris de tecnologies de suport, les opinions que ha rebut el grup de treball sobre quina opció és preferible han estat dividides. Aquesta tècnica permet que els usuaris triïn l'enfocament que els funcioni millor.
Es proporciona un enllaç a prop del principi de la pàgina que ampliarà el text dels enllaços de la pàgina, de manera que no calgui cap context addicional per entendre el propòsit de cap enllaç. Sempre ha de ser possible entendre el propòsit de l'enllaç d'ampliació directament a partir del seu text.
Aquesta tècnica amplia els enllaços únicament per a la vista actual de la pàgina. També és possible, i en alguns casos seria recomanable, desar aquesta preferència en una galeta o en un perfil d'usuari del costat del servidor, de manera que els usuaris només hagin de fer la selecció una vegada per lloc.
Exemples
Aquest exemple utilitza JavaScript per afegir informació contextual directament al text d'un enllaç. La classe de l'enllaç s'utilitza per determinar quin text addicional s'hi ha d'afegir. Quan s'activa l'enllaç «Expand Links» (amplia els enllaços), s'examina cada enllaç de la pàgina per veure si s'hi ha d'afegir text addicional.
...
<script>
var expanded = false;
var linkContext = {
"hist":" version of The History of the Web",
"cook":" version of Cooking for Nerds"
};
function doExpand() {
var links = document.links;
for (var i=0; i<links.length; i++) {
var link = links[i];
var cn = link.className;
if (linkContext[cn]) {
span = link.appendChild(document.createElement("span"));
span.setAttribute("class", "linkexpansion");
span.appendChild(document.createTextNode(linkContext[cn]));
}
}
objUpdate = document.getElementById('expand');
if (objUpdate) {
objUpdate.childNodes[0].nodeValue = "Collapse links";
}
expanded = true;
}
function doCollapse() {
objUpdate = document.getElementById('expand');
var spans = document.getElementsByTagName("span");
var span;
// go backwards through the set as removing from the front changes indices
// and messes up the process
for (i = spans.length - 1; i >= 0; i--) {
span = spans[i];
if (span.getAttribute("class") == "linkexpansion")
span.parentNode.removeChild(span);
}
if (objUpdate) {
objUpdate.childNodes[0].nodeValue = "Expand links";
}
expanded = false;
}
function toggle() {
if (expanded) doCollapse();
else doExpand();
}
</script>
...
<h1>Books for download</h1>
<p><button id="expand" onclick="toggle(); type="button">Expand Links</button></p>
<ul>
<li>The History of the Web:
<a href="history.docx" class="hist">Word</a>,
<a href="history.pdf" class="hist">PDF</a>,
<a href="history.html" class="hist">HTML</a>
</li>
<li>Cooking for Nerds:
<a href="history.docx" class="cook">Word</a>,
<a href="history.pdf" class="cook">PDF</a>,
<a href="history.html" class="cook">HTML</a>
</li>
</ul>
...
Exemple funcional d'aquest codi: Providing link expansions on demand (ampliar els enllaços a petició).
Proves
Procediment
- Comprovar que hi ha un enllaç a prop del principi de la pàgina per ampliar els enllaços.
- Comprovar que l'enllaç identificat al pas 1 es pot identificar únicament a partir del text de l'enllaç.
- Localitzar els enllaços de la pàgina que no es puguin identificar únicament a partir del text de l'enllaç.
- Activar el control identificat al pas 1.
- Comprovar que ara el propòsit dels enllaços identificats al pas 3 es pot identificar únicament a partir del text de l'enllaç.
Resultats esperats
- Les comprovacions núm. 1, núm. 2 i 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.
Basat en la tècnica SCR30 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.