Teknika Bezero-scriptak WCAG 2.2
SCR19Goitibeherako zerrenda bat beste batean aukeratutakoaren arabera eguneratzea, orriz aldatu gabe
Izen ofiziala W3Cn: onchange gertaera bat select elementu batean erabiltzea, testuinguru-aldaketarik eragin gabe
Laburbilduz
Ohikoa da goitibeherako zerrenda batean aukera bat hautatzean beste baten aukerak aldatzea, probintzia eta udalerria, adibidez. Teknika honek JavaScript bidez egiten du, orriz aldatu gabe eta fokua mugitu gabe. Aldatzen den zerrenda beti dago aldaketa eragiten duenaren ondoren.
Zergatik da garrantzitsua
Teklatua erabiltzen duenak gezi-teklekin igarotzen ditu goitibeherako zerrenda baten aukerak. Nabigatzaile batzuetan, gezi-tekla bakoitza aldaketatzat hartzen da jada.
Aldaketa horrek formularioa bidaliko balu edo beste orri bat irekiko balu, pertsona nahi gabe irtengo litzateke. Dagoeneko atzean utzi duen zerrenda bat eguneratzen badu, ez litzateke aldaketaz jabetuko.
Nola egiten da
- Erabili lehen zerrendaren
changegertaera bigarrena betetzeko soilik. Ez bidali formularioa eta ez aldatu orriz. - Jarri eguneratzen den zerrenda lehenengoaren ondoren, kodean eta pantailan.
- Izan orrian behar diren datuak, edo kargatu itzazu azkar eta fokua mugitu gabe.
- Utzi fokua dagoen lekuan. Pertsonak aukera berriak aurkituko ditu tabuladorearekin aurrera egitean.
- Beharrezkoa bada, gehitu bigarren eremua lehenengoaren mende dagoela azaltzen duen testu bat.
Nola egiaztatu
- Teklatuarekin, aukeratu aukera bat lehen zerrendan.
- Joan tabuladorearekin bigarrenera eta egiaztatu aukera zuzenak erakusten dituela.
- Itzuli lehenengora eta igaro haren aukerak gezi-teklekin. Ez du orriz aldatu behar, eta fokuak ez du mugitu behar.
- Probatu pantaila-irakurgailu batekin ere.
Adibidea
Probintzia aukeratzean, udalerrien zerrenda betetzen da, eta zerrenda hori berehala dator ondoren.
<label for="provincia">Probintzia</label>
<select id="provincia">
<option value="murcia">Murtzia</option>
<option value="alicante">Alacant</option>
</select>
<label for="municipio">Udalerria</label>
<select id="municipio"></select>
<script>
provincia.addEventListener("change", () => rellenarMunicipios(provincia.value));
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR19 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Scriptekin bateragarria den HTMLa.
Deskribapena
Teknika honen helburua da erakustea nola erabili behar den behar bezala onchange gertaera bat select elementu batekin web-orriko beste elementu batzuk eguneratzeko. Teknika honek ez du testuinguru-aldaketarik eragiten. Web-orrian select elementu bat edo gehiago daudenean, haietako batean onchange gertaera batek web-orriko beste select elementu baten aukerak egunera ditzake. Select elementuek behar dituzten datu guztiak web-orriaren barruan daude.
Garrantzitsua da azpimarratzea aldatzen den select elementua web-orriaren irakurketa-ordenan abiarazle den select elementuaren ondoren kokatuta dagoela. Horri esker, laguntza-teknologiek aldaketa hautematen dute, eta erabiltzaileek datu berriak aurkitzen dituzte aldatutako elementuak fokua jasotzen duenean. Teknika hau erabiltzaile-agentearen JavaScript bateragarritasunaren mende dago.
Adibideak
Adibide honek bi select elementu ditu. Lehen select-ean elementu bat hautatzen denean, beste select-eko aukerak horren arabera eguneratzen dira. Lehen select elementuak kontinenteen zerrenda bat du. Bigarren select elementuak hautatutako kontinentean dauden herrialdeen zerrenda partzial bat izango du. Kontinenteen select-ari onchange gertaera bat dago lotuta. Kontinentearen hautapena aldatzen denean, herrialdeen select-eko elementuak JavaScript bidez aldatzen dira, Document Object Model (DOM) delakoaren bitartez. Behar diren datu guztiak, herrialdeen eta kontinenteen zerrenda, web-orriaren barruan daude.
Jarraian dagoen kodearen laburpena
countryListsarray motako aldagaia, abiarazle den select elementuko kontinente bakoitzeko herrialdeen zerrenda duena.countryChange()funtzioa, kontinenteen select elementuaren onchange gertaerak deitzen duena.- Select elementuak web-orriaren gorputzean sortzeko HTML kodea.
<!doctype html>
<html lang="en">
<head>
<meta charset=utf-8">
<title>Dynamic Select Statements</title>
<script>
// array of possible countries in the same order as they appear
// in the country selection list
var countryLists = new Array(4)
countryLists["empty"] = ["Select a Country"];
countryLists["North America"] = ["Canada", "United States", "Mexico"];
countryLists["South America"] = ["Brazil", "Argentina", "Chile", "Ecuador"];
countryLists["Asia"] = ["Russia", "China", "Japan"];
countryLists["Europe"]= ["Britain", "France", "Spain", "Germany"];
/* CountryChange() is called from the onchange event of a select element.
* param selectObj - the select object which fired the on change event.
*/
function countryChange(selectObj) {
// get the index of the selected option
var idx = selectObj.selectedIndex;
// get the value of the selected option
var which = selectObj.options[idx].value;
// use the selected option value to retrieve the list of items
// from the countryLists array
cList = countryLists[which];
// get the country select element via its known id
var cSelect = document.getElementById("country");
// remove the current options from the country select
var len=cSelect.options.length;
while (cSelect.options.length > 0) {
cSelect.remove(0);
}
var newOption;
// create new options
for (var i=0; i<cList.length; i++) {
newOption = document.createElement("option");
newOption.value = cList[i]; // assumes option string and value are the same
newOption.text=cList[i];
// add the new option
try {
cSelect.add(newOption); // this will fail in DOM browsers but is needed for IE
}
catch (e) {
cSelect.appendChild(newOption);
}
}
}
</script>
</head>
<body>
<h1>Dynamic Select Statements</h1>
<label for="continent">Select Continent</label>
<select id="continent" onchange="countryChange(this);">
<option value="empty">Select a Continent</option>
<option value="North America">North America</option>
<option value="South America">South America</option>
<option value="Asia">Asia</option>
<option value="Europe">Europe</option>
</select>
<div>
<label for="country">Select a country</label>
<select id="country">
<option value="0">Select a country</option>
</select>
</div>
</body>
</html>
Hona hemen adibide praktiko bat: Dynamic Select (select dinamikoa)
Probak
Prozedura
- Nabigatu abiarazle den select elementuraino (adibide honetan, kontinenteak hautatzekoa) eta aldatu select-aren balioa.
- Nabigatu abiarazleak eguneratzen duen select elementuraino (adibide honetan, herrialdeak hautatzekoa).
- Egiaztatu beste select elementuan dagozkion aukera-balioak erakusten direla.
- Nabigatu abiarazle den select elementuraino eta igaro aukerak balioa aldatu gabe.
- Egiaztatu lotutako elementuan dagozkion aukera-balioak erakusten jarraitzen dutela.
Gomendagarria da select elementuak laguntza-teknologia batekin probatzea, lotutako elementuko aldaketak ezagutzen direla egiaztatzeko.
Espero diren emaitzak
- 3. eta 5. egiaztapenak egiazkoak dira.
Baliabideak
- Accessible Forms using WCAG 2.0 (formulario irisgarriak WCAG 2.0 erabiliz)
- Testuinguru-aldaketaren definizioa
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR19 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.