Teknika Bezero-scriptak WCAG 2.2
SCR18Formulario bateko datuak nabigatzailean balidatzea eta errorea azaltzea
Izen ofiziala W3Cn: Bezeroaren aldeko balidazioa eta alerta ematea
Laburbilduz
Teknika honek JavaScript bidez egiaztatzen ditu formulario bateko datuak bidali aurretik. Zerbait gaizki badago, testu bidez azaltzen du zein den errorea, eta fokua eraginpeko eremura eramaten du. Horrela, pertsonak badaki zer zuzendu behar duen, zerbitzariak bidalketa baztertu arte itxaron gabe.
Zergatik da garrantzitsua
Ertz gorri batekin soilik markatzen den errore bat oharkabean pasatzen zaio pertsona itsu bati edo daltonismoa duen bati. «Datu okerrak» bezalako mezu orokor batek ere ez dio inori laguntzen.
Formularioak esaten badu zein eremutan dagoen akatsa eta zergatik, edonork zuzen dezake. Adibidez: «Jaiotze-datak hh/hh/uuuu formatua izan behar du».
Nola egiten da
- Egiaztatu eremu bakoitza handik irtetean edo «Bidali» sakatzean.
- Errore bat badago, deskribatu testu bidez arazoa eta nola konpondu.
- Errazena
alert()bat da. Hobe da mezua orrian bertan erakustea, eremuaren ondoan, etaaria-describedbybidez lotzea. - Eraman fokua errorea duen lehen eremura, pertsonak berehala zuzendu ahal izan dezan.
- Hainbat errore badaude, erakutsi zerrenda bat hasieran, eremu bakoitzerako estekekin.
- Balidatu zerbitzarian ere. Nabigatzailearen balidazioak laguntzen du, baina ez da nahikoa.
Nola egiaztatu
- Bete formularioa datu okerrekin, ezinezkoa den data batekin edo a bildurik gabeko helbide elektroniko batekin, adibidez.
- Bidali eta egiaztatu errorea hitzez azaltzen duen mezu bat agertzen dela.
- Egiaztatu fokua eremu okerrean geratzen dela edo mezuak hara iristeko aukera ematen duela.
- Pantaila-irakurgailu batekin, egiaztatu mezua irakurtzen dela.
Adibidea
Data baten egiaztapena aurretiko hitzordu baterako formulario bat bidaltzean.
form.addEventListener("submit", (e) => {
const fecha = document.getElementById("fecha");
if (!/^\d{2}\/\d{2}\/\d{4}$/.test(fecha.value)) {
e.preventDefault();
document.getElementById("error-fecha").textContent =
"Idatzi data hh/hh/uuuu formatuarekin.";
fecha.setAttribute("aria-invalid", "true");
fecha.focus();
}
});
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR18 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Erabiltzaileak sartutako datuak balidatzen dituen edukia.
Deskribapena
Teknika honen helburua da erabiltzaileak sartutako datuak balidatzea, eremu bakoitzean balioak sartu ahala, bezeroaren aldeko scripten bidez. Erroreak aurkitzen badira, alerta-koadro batek testu bidez deskribatzen du errorearen nolakotasuna. Erabiltzaileak alerta-koadroa ixten duenean, baliagarria da scriptak teklatuaren fokua errorea gertatu den eremuan jartzea.
Adibideak
Kontrol bakar bat egiaztatzea gertaera-kudeatzaile batekin
Hurrengo scriptak egiaztatuko du formulario-kontrolean data baliodun bat sartu dela.
<label for="date">Date:</label>
<input type="text" name="date" id="date"
onchange="if(isNaN(Date.parse(this.value)))
alert('This control is not a valid date.
Please re-enter the value.');">
Hainbat kontrol egiaztatzea erabiltzaileak formularioa bidaltzen duenean
Hurrengo adibideak formulario bateko hainbat kontrol erakusten ditu. form elementuak onsubmit atributua erabiltzen du, eta horrek gertaera-kudeatzaile bat sortzen du balidazio-scripta exekutatzeko erabiltzailea formularioa bidaltzen saiatzen denean. Balidazioak arrakasta badu, gertaerak true itzultzen du eta formularioaren bidalketak aurrera egiten du; balidazioak erroreak aurkitzen baditu, errore-mezu bat erakusten du eta false itzultzen du bidalketa-saiakera bertan behera uzteko, erabiltzaileak arazoak zuzendu ahal izan ditzan.
Adibide honek alerta bat erabiltzen du, sinpletasunagatik. Erabiltzailearentzat jakinarazpen baliagarriagoa izango litzateke arazoak dituzten kontrolak nabarmentzea eta orrian informazioa gehitzea erroreen nolakotasunari buruz eta datuak zuzendu behar zaizkien kontroletara nola iritsi jakiteko.
Adibide honek form elementuko onsubmit atributu bat erabiltzen badu ere, laburtasunagatik, ohiko praktika da orria kargatzen denean bidalketa-gertaeraren entzule bat sortzea.
Scriptaren kodea:
function validate() {
// initialize error message
var msg = "";
//validate name
var pattern = /^[a-zA-Z\s]+$/;
var el = document.getElementById("name");
if (!pattern.test(el.value)) {
msg += "Name can only have letters and spaces. ";
}
// validate number
var pattern = /^[\d\-+\.\s]+$/;
var el = document.getElementById("tel");
if (!pattern.test(el.value)) {
msg += "Telephone number can only have digits and separators. ";
}
if (msg != "") {
alert(msg);
return false;
}
else {
return true;
}
Formularioaren kodea:
<form action="multiple-controls.html" onsubmit="return validate()">
<div>
<label for="name">Name:</label>
<input autocomplete="name" id="name" name="name" type="text">
</div>
<div>
<label for="tel">Telephone number:</label>
<input autocomplete="tel" id="tel" name="tel" type="tel">
</div>
<div>
<input type="submit">
</div>
</form>
Funtzionamenduan ikus daiteke erabiltzaileak formularioa bidaltzen duenean hainbat kontrol egiaztatzeko adibide praktikoan.
Probak
Prozedura
Datu zehatzak sartzea eskatzen duten formulario-eremuetarako:
- Sartu baliozkoak ez diren datuak.
- Zehaztu errorea deskribatzen duen alerta bat ematen den.
Espero diren emaitzak
- 2. egiaztapena egiazkoa da.
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR18 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.