Técnica Scripts de cliente WCAG 2.2
SCR18Proporcionar validación y alerta en el lado del cliente
En resumen
Esta técnica describe cómo validar con JavaScript los datos que el usuario introduce en un formulario y, si hay errores, describirlos en texto mediante un cuadro de alerta, devolviendo después el foco al campo afectado. Resulta útil en cualquier formulario con campos que exigen un formato concreto (fechas, teléfonos, nombres) y ayuda a todas las personas a corregir sus errores de inmediato, sin esperar la respuesta del servidor.
Aplicabilidad
Contenido que valida la entrada del usuario.
Descripción
El objetivo de esta técnica es validar la entrada del usuario a medida que se introducen los valores en cada campo, mediante scripts en el lado del cliente. Si se encuentran errores, un cuadro de diálogo de alerta describe en texto la naturaleza del error. Una vez que el usuario cierra el cuadro de alerta, resulta útil que el script sitúe el foco del teclado en el campo donde se produjo el error.
Ejemplos
Comprobar un único control con un manejador de eventos
El siguiente script comprobará que se ha introducido una fecha válida en el control de formulario.
<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.');">
Comprobar varios controles cuando el usuario envía el formulario
El siguiente ejemplo muestra varios controles en un formulario. El elemento form utiliza el atributo onsubmit, que crea un manejador de eventos para ejecutar el script de validación cuando el usuario intenta enviar el formulario. Si la validación tiene éxito, el evento devuelve true y el envío del formulario continúa; si la validación encuentra errores, muestra un mensaje de error y devuelve false para cancelar el intento de envío, de modo que el usuario pueda corregir los problemas.
Este ejemplo utiliza una alerta por simplicidad. Una notificación más útil para el usuario consistiría en resaltar los controles con problemas y añadir información a la página sobre la naturaleza de los errores y sobre cómo llegar a los controles cuyos datos hay que corregir.
Aunque este ejemplo utiliza un atributo onsubmit en el elemento form por brevedad, la práctica habitual es crear un escuchador del evento de envío cuando se carga la página.
Código del 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;
}
Código del formulario:
<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>
Puede verse en funcionamiento en el ejemplo práctico de comprobación de varios controles cuando el usuario envía el formulario.
Pruebas
Procedimiento
Para los campos de formulario que requieren una entrada específica:
- Introducir datos no válidos.
- Determinar si se proporciona una alerta que describa el error.
Resultados esperados
- La comprobación n.º 2 es verdadera.
Cómo lo comprobamos en ADDAW
En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.
Fuente y licencia
Traducción al español, no oficial, realizada por ADDAW a partir de la técnica SCR18 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.