Tècnica Scripts de client WCAG 2.2
SCR18Validar les dades d'un formulari al navegador i explicar l'error
Nom oficial al W3C: Proporcionar validació i alerta al costat del client
En poques paraules
Aquesta tècnica comprova amb JavaScript les dades d'un formulari abans d'enviar-lo. Si alguna cosa no és correcta, explica amb text quin és l'error i porta el focus al camp afectat. Així la persona sap què ha de corregir sense esperar que el servidor rebutgi l'enviament.
Per què és important
Un error que només es marca amb una vora vermella passa desapercebut per a una persona cega o amb daltonisme. Un missatge genèric com «Dades incorrectes» tampoc no ajuda ningú.
Si el formulari diu quin camp falla i per què, qualsevol persona el pot corregir. Per exemple: «La data de naixement ha de tenir el format dd/mm/aaaa».
Com es fa
- Comproveu cada camp en sortir-ne o en prémer «Envia».
- Si hi ha un error, descriviu en text el problema i com resoldre'l.
- El més senzill és un
alert(). És millor mostrar el missatge a la pàgina, al costat del camp, i relacionar-lo ambaria-describedby. - Porteu el focus al primer camp amb error perquè la persona el pugui corregir de seguida.
- Si hi ha diversos errors, mostreu una llista al principi amb enllaços a cada camp.
- Valideu també al servidor. La validació del navegador ajuda, però no n'hi ha prou.
Com comprovar-ho
- Empleneu el formulari amb dades incorrectes, per exemple una data impossible o un correu sense arrova.
- Envieu-lo i comproveu que apareix un missatge que explica l'error amb paraules.
- Confirmeu que el focus queda al camp erroni o que el missatge permet arribar-hi.
- Amb un lector de pantalla, verifiqueu que el missatge es llegeix.
Exemple
Comprovació d'una data en enviar un formulari de cita prèvia.
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 =
"Escriviu la data amb el format dd/mm/aaaa.";
fecha.setAttribute("aria-invalid", "true");
fecha.focus();
}
});
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR18 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
Contingut que valida l'entrada de l'usuari.
Descripció
L'objectiu d'aquesta tècnica és validar l'entrada de l'usuari a mesura que s'introdueixen els valors a cada camp, mitjançant scripts al costat del client. Si es troben errors, un quadre de diàleg d'alerta descriu en text la naturalesa de l'error. Un cop l'usuari tanca el quadre d'alerta, és útil que l'script situï el focus del teclat al camp on s'ha produït l'error.
Exemples
Comprovar un únic control amb un gestor d'esdeveniments
L'script següent comprovarà que s'ha introduït una data vàlida al control de formulari.
<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.');">
Comprovar diversos controls quan l'usuari envia el formulari
L'exemple següent mostra diversos controls en un formulari. L'element form utilitza l'atribut onsubmit, que crea un gestor d'esdeveniments per executar l'script de validació quan l'usuari intenta enviar el formulari. Si la validació té èxit, l'esdeveniment retorna true i l'enviament del formulari continua; si la validació troba errors, mostra un missatge d'error i retorna false per cancel·lar l'intent d'enviament, de manera que l'usuari pugui corregir els problemes.
Aquest exemple utilitza una alerta per simplicitat. Una notificació més útil per a l'usuari consistiria a ressaltar els controls amb problemes i afegir informació a la pàgina sobre la naturalesa dels errors i sobre com arribar als controls les dades dels quals cal corregir.
Tot i que aquest exemple utilitza un atribut onsubmit a l'element form per brevetat, la pràctica habitual és crear un detector de l'esdeveniment d'enviament quan es carrega la pàgina.
Codi de l'script:
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;
}
Codi del formulari:
<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>
Es pot veure en funcionament a l'exemple pràctic de comprovació de diversos controls quan l'usuari envia el formulari.
Proves
Procediment
Per als camps de formulari que requereixen una entrada específica:
- Introduir dades no vàlides.
- Determinar si es proporciona una alerta que descrigui l'error.
Resultats esperats
- La comprovació núm. 2 és certa.
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 SCR18 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.