El evento submit
Escucha submit en el formulario, no click en el botón: también se dispara al pulsar Enter en un campo. Y cancela el envío por defecto, que recargaría la página:
document.body.innerHTML = `
<form id="buscar">
<input name="q" value="javascript">
<button>Buscar</button>
</form>`;
const form = document.querySelector("#buscar");
form.addEventListener("submit", (e) => {
e.preventDefault();
console.log("buscando:", form.q.value);
});
form.requestSubmit(); // como si el usuario pulsara el botón
Los campos se pueden leer por su name directamente desde el formulario: form.q, form.email.
FormData
FormData junta todos los campos con name de una vez. Se puede enviar directamente con fetch, o convertir en un objeto:
document.body.innerHTML = `
<form id="pedido">
<input name="producto" value="té">
<input name="cantidad" type="number" value="2">
<select name="envio"><option>normal</option><option selected>express</option></select>
</form>`;
const datos = new FormData(document.querySelector("#pedido"));
const pedido = Object.fromEntries(datos);
console.log(pedido);
console.log(Number(pedido.cantidad) * 3); // los valores son textos
Mientras el usuario escribe
input: con cada cambio, letra por letra.change: cuando el valor queda confirmado (al salir del campo, o al elegir en unselecto checkbox).
document.body.innerHTML = `<input id="nombre"> <p id="vista"></p>`;
const campo = document.querySelector("#nombre");
const vista = document.querySelector("#vista");
campo.addEventListener("input", () => {
vista.textContent = `Hola, ${campo.value || "…"}`;
});
campo.value = "Ana";
campo.dispatchEvent(new Event("input")); // simula que el usuario escribió
console.log(vista.textContent);
Validar con HTML
Los atributos de HTML ya validan: required, type="email", min, max, minlength, pattern… y la API de validación te deja consultar el resultado desde JavaScript:
document.body.innerHTML = `<input id="edad" type="number" min="18" required>`;
const edad = document.querySelector("#edad");
edad.value = "15";
console.log(edad.checkValidity()); // false
console.log(edad.validity.rangeUnderflow); // por qué: debajo del mínimo
console.log(edad.validationMessage); // el mensaje del navegador
edad.value = "30";
console.log(edad.checkValidity());
form.checkValidity() comprueba todos los campos; form.reportValidity() además muestra los mensajes del navegador. En CSS, las pseudoclases :invalid y :user-invalid (esta última, solo después de que el usuario tocó el campo) permiten dar estilo a los errores.
Reglas propias
Para reglas que HTML no tiene, setCustomValidity marca un campo como inválido con tu mensaje, y "" lo vuelve válido:
document.body.innerHTML = `<input id="clave" value="secreto1"> <input id="repetir" value="secreto2">`;
const clave = document.querySelector("#clave");
const repetir = document.querySelector("#repetir");
function comprobar() {
repetir.setCustomValidity(repetir.value === clave.value ? "" : "Las contraseñas no coinciden");
}
comprobar();
console.log(repetir.checkValidity(), repetir.validationMessage);
repetir.value = "secreto1";
comprobar();
console.log(repetir.checkValidity());
Resumen
- Escucha
submiten el formulario y llama apreventDefault(). - Lee los campos por su
nameo conFormData; los valores son siempre textos. inputcon cada cambio;changeal confirmar.- La validación de HTML (
required,type,min,pattern) se consulta concheckValidity()yvalidity. setCustomValidityagrega reglas propias.- El servidor siempre valida de nuevo.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Datos que llegan del usuario
Resuelto
Elige una respuesta en cada pregunta.
¿Qué evento conviene escuchar para enviar un formulario?
¿Qué hace
new FormData(form)?Un
<input type="number">, ¿qué devuelve suvalue?¿Qué hace
input.setCustomValidity("mensaje")?
Ordena la salida: Leer un formulario
Resuelto
Un formulario con casillas repetidas y un campo numérico. Ordena lo que aparecería en la consola.
1document.body.innerHTML = `2 <form id="f">3 <input name="nombre" value="Ana">4 <input name="interes" type="checkbox" value="js" checked>5 <input name="interes" type="checkbox" value="css" checked>6 <input name="interes" type="checkbox" value="sql">7 <input name="edad" type="number" value="31">8 </form>`;9 10const datos = new FormData(document.querySelector("#f"));11console.log(datos.get("nombre"));12console.log(datos.getAll("interes").join(","));13console.log(typeof datos.get("edad"));14console.log(Object.fromEntries(datos).interes);Consola, de arriba abajo
- string
- Ana
- css
- js,css
Las casillas sin marcar no aparecen; las marcadas con el mismo name se leen con getAll. Todos los valores son textos, aunque el campo sea numérico. Object.fromEntries se queda con el último valor de cada nombre.
Detective: Un campo con otro nombre
Resuelto
Al enviar el formulario, la consola muestra un error. Encuentra la línea y elige el arreglo.
Consola
Uncaught TypeError: Cannot read properties of undefined (reading 'value')
at HTMLFormElement.<anonymous> (index.html:10:41)Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Un registro validado
Resuelto
Maneja el envío del formulario: valida, lee los datos y muestra un mensaje en la página.
La página index.html
Consola del navegador
Lo que debe cumplir
- Con datos válidos, muestra
Hola, Ana (ana@mail.com)(pendiente) - Con un email inválido, muestra
Revisa los campos(pendiente) - Usa
preventDefaultyFormData(pendiente)
Una solución
1const form = document.querySelector("#registro");2const mensaje = document.querySelector("#mensaje");3 4form.addEventListener("submit", (e) => {5 e.preventDefault();6 if (!form.checkValidity()) {7 mensaje.textContent = "Revisa los campos";8 return;9 }10 const datos = new FormData(form);11 mensaje.textContent = `Hola, ${datos.get("nombre")} (${datos.get("email")})`;12});13 14form.nombre.value = "Ana";15form.email.value = "ana@mail.com";16form.requestSubmit();El formulario tiene novalidate para que el navegador no muestre sus propios globos de error y la validación la controle tu código, pero las reglas de HTML (required, type="email") siguen funcionando a través de checkValidity(). requestSubmit() envía el formulario como si el usuario pulsara el botón.