CKTIS / JavaScript
Formularios y validez
Usa `input` para reaccionar a los cambios en un campo y `submit` para gestionar el envío del formulario una vez superada la validación habitual. `HTMLFormElement` también ofrece métodos para comprobar explícitamente la validez del formulario.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement es la interfaz del DOM del navegador que representa un elemento form. La propiedad form.elements permite acceder a los controles asociados al formulario. Es una API web, no una parte del lenguaje ECMAScript.
Escucha el evento input para reaccionar a los cambios del usuario, por ejemplo, para actualizar una indicación mientras escribe. Asignar un valor a field.value en JavaScript no dispara por sí solo el evento input. El atributo required hace que un campo de texto vacío no sea válido. form.checkValidity() devuelve el resultado como un valor booleano. form.reportValidity() también devuelve un valor booleano y muestra al usuario los errores de validación, salvo que se cancele el evento invalid del control afectado. Cancelar ese evento no cambia el resultado de la validación: el método devuelve false sin mostrar un error para ese control.
En un intento de envío normal, el navegador comprueba primero las restricciones. Si un campo no es válido, el navegador bloquea el envío y no se dispara el evento submit. Si la validación se supera, submit se dispara en el formulario, no en el botón. Llamar a event.preventDefault() en el manejador cancela el envío predeterminado.
Usa form.requestSubmit() para iniciar el mismo proceso desde el código. Llamar directamente a form.submit() omite tanto la validación como el evento submit. La validación en el navegador ayuda a los usuarios a corregir los datos introducidos, pero no sustituye a la validación en el servidor.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
<label>Name <input name="displayName" required></label>
<button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
const form = document.querySelector('#profile');
const field = form.elements.namedItem('displayName');
const log = document.querySelector('#log');
const append = (line) => { log.textContent += line + '\n'; };
field.addEventListener('input', () => {
append(`input: ${form.checkValidity()}`);
});
form.addEventListener('submit', (event) => {
event.preventDefault();
append(`submit: ${field.value}`);
});
append(`initial: ${form.checkValidity()}`);
</script>Resultado
initial: false input: true submit: A
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.