Teknika Bezero-scriptak WCAG 2.2
SCR30Esteken testua eskatuta osatzen duen kontrol bat eskaintzea
Izen ofiziala W3Cn: Scriptak erabiltzea esteken testua aldatzeko
Laburbilduz
Esteka batzuk inguruan dutenagatik bakarrik ulertzen dira, albiste-zerrenda bateko «Irakurri gehiago» batzuk, adibidez. Teknika honek orriaren hasieran kontrol bat jartzen du, eta, aktibatzean, esteka horien testua osatzen du JavaScript bidez. Horrela, pertsona bakoitzak aukeratzen du esteka laburrak nahi dituen ala berez ulertzen diren estekak.
Zergatik da garrantzitsua
Pantaila-irakurgailua (pantailan dagoena ozen irakurtzen duen programa) erabiltzen duten pertsona askok orriko esteka guztien zerrenda bat kontsultatzen dute. Zerrenda horretan, hamar «Irakurri gehiago»-k ez dute ezer esaten.
Beste pertsona batzuek testu laburrak nahiago dituzte, esteka bakoitzean testuingurua entzutea errepikakorra iruditzen zaielako. Teknika honekin, bakoitzak erosoen zaion aukera hautatzen du.
Nola egiten da
- Jarri orriaren hasieratik gertu botoi edo esteka bat, berez ulertzen den testu batekin, «Erakutsi estekak testu osoarekin», adibidez.
- Markatu testuingurua behar duten estekak. Adibidez, falta den testua gordetzen duen
data-atributu batekin. - Kontrola aktibatzean, scriptak testu hori gehitzen du esteka bakoitzaren barruan. «Irakurri gehiago» «Irakurri gehiago alokairurako laguntzei buruz» bihurtzen da.
- Eman bertsio laburrera itzultzeko aukera kontrol berarekin.
- Ahal bada, gogoratu aukera cookie batean edo pertsonaren profilean. Horrela, ez du orri bakoitzean errepikatu beharko.
Nola egiaztatu
- Egiaztatu orriaren hasieratik gertu estekak zabaltzeko kontrol bat dagoela eta haren testua berez ulertzen dela.
- Idatzi inguruan dagoena irakurri gabe helmuga ulertzen ez zaien estekak.
- Aktibatu kontrola.
- Berrikusi berriro esteka horiek. Orain, haien testuak, berez, nora daramaten azaldu behar du. Pantaila-irakurgailuaren esteka-zerrendak hori ikusten laguntzen du (NVDAn, Insert + F7).
Adibidea
Botoi batek «Irakurri gehiago» bakoitzari haren helmuga azaltzen duen testua gehitzen dio.
<button type="button" id="ampliar">Erakutsi estekak testu osoarekin</button>
<h2>Alokairurako laguntzak</h2>
<p>Epea irekita azaroaren 30era arte.
<a href="/ayudas-alquiler" data-extra=" alokairurako laguntzei buruz">Irakurri gehiago</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>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR30 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTMLrekin erabiltzen diren bezeroaren aldeko scriptak
Deskribapena
Teknika honen helburua da erabiltzaileei aukera ematea esteken testuari informazio gehigarria eranstea hauta dezaten, estekak testuingurutik kanpo uler daitezen.
Erabiltzaile batzuek berez osoak diren estekak nahiago dituzte, estekaren testuingurua arakatu beharrik ez dutenak. Beste erabiltzaile batzuen ustez, esteka bakoitzean testuinguruko informazioa sartzea errepikakorra da eta webgunea erabiltzeko gaitasuna murrizten die. Laguntza-teknologien erabiltzaileen artean, iritziak zatituta egon dira lan-taldeak zein aukera den hobea jaso dituen iruzkinetan. Teknika honi esker, erabiltzaileek hobekien funtzionatzen dien ikuspegia hauta dezakete.
Orriaren hasieratik gertu esteka bat ematen da, orriko esteken testua zabalduko duena, esteka baten helburua ere ulertzeko testuinguru gehigarririk behar ez izateko. Zabaltzeko estekaren helburua haren testutik zuzenean ulertu ahal izan behar da beti.
Teknika honek orriaren uneko ikuspegirako soilik zabaltzen ditu estekak. Hobespen hori cookie batean edo zerbitzariaren aldeko erabiltzaile-profil batean gordetzea ere posible da, eta zenbait kasutan gomendagarria litzateke, erabiltzaileek webgune bakoitzean behin bakarrik egin behar izan dezaten hautaketa.
Adibideak
Adibide honek JavaScript erabiltzen du testuinguruko informazioa zuzenean esteka baten testuari gehitzeko. Estekaren klasea erabiltzen da zer testu gehigarri gehitu behar den zehazteko. «Expand Links» (zabaldu estekak) esteka aktibatzen denean, orriko esteka bakoitza aztertzen da testu gehigarria gehitu behar zaion ikusteko.
...
<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>
...
Kode honen adibide funtzionala: Providing link expansions on demand (estekak eskatuta zabaltzea).
Probak
Prozedura
- Egiaztatzea orriaren hasieratik gertu estekak zabaltzeko esteka bat dagoela.
- Egiaztatzea 1. urratsean identifikatutako esteka estekaren testutik soilik identifika daitekeela.
- Orrian estekaren testutik soilik identifikatu ezin diren estekak aurkitzea.
- 1. urratsean identifikatutako kontrola aktibatzea.
- Egiaztatzea 3. urratsean identifikatutako esteken helburua orain estekaren testutik soilik identifika daitekeela.
Espero diren emaitzak
- 1., 2. eta 5. 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.
W3Cren SCR30 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.