CKTIS / JavaScript
Eventos `submit` e `input` en formularios HTML
Usa `input` para reaccionar a las ediciones y `submit` para gestionar el envío del formulario en el momento adecuado del proceso de validación.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();input se dispara en el control editado y se propaga hacia arriba por el árbol DOM. En un escuchador del formulario, event.target identifica el control y event.currentTarget identifica el formulario mientras se ejecuta el escuchador. Si el control está fuera del formulario y se asocia mediante el atributo form, esa asociación por sí sola no hace que el evento llegue al formulario. Usa input para dar respuesta durante la edición; change señala que se ha confirmado el cambio, normalmente al perder el foco en un campo de texto. Asignar a .value no dispara input por sí solo.
submit se dispara en el formulario, no en el botón. Es un SubmitEvent que se propaga y se puede cancelar. Escúchalo en lugar del click de un botón para gestionar también el envío implícito, por ejemplo al pulsar Intro cuando el navegador lo admite. event.submitter identifica el botón de envío o vale null si ningún botón inició el envío. Para impedir el envío predeterminado, llama a event.preventDefault() en el escuchador antes de cualquier await.
form.requestSubmit() sigue las reglas normales de envío sin elegir un botón. form.requestSubmit(button) usa ese botón y respeta sus ajustes, como formaction y formnovalidate. Si no se omite la validación de restricciones y esta falla, los controles no válidos reciben invalid y no se dispara submit. Pasar un elemento que no es un botón de envío lanza TypeError; pasar un botón de envío que no pertenece a ese formulario lanza NotFoundError.
Llamar directamente a form.submit() omite la validación de restricciones y no dispara submit. Un control cuyo name o id sea submit puede ocultar el método. La validación en el navegador no sustituye a la validación en el servidor. Son API de la plataforma web, no de ECMAScript 2024; comprueba la compatibilidad en el entorno de destino.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
const form = document.createElement("form");
const field = document.createElement("input");
field.type = "text";
field.required = true;
const button = document.createElement("button");
button.type = "submit";
button.value = "save";
button.textContent = "Save";
form.append(field, button);
field.addEventListener("invalid", (event) => {
event.preventDefault();
console.log("invalid");
});
form.addEventListener("input", (event) => {
if (event.target === field) console.log(`input: ${field.value}`);
});
form.addEventListener("submit", (event) => {
event.preventDefault();
console.log(`submit: ${event.submitter.value}`);
});
document.body.append(form);
try {
form.requestSubmit(button);
field.value = "Ada";
console.log(`set: ${field.value}`);
field.dispatchEvent(new Event("input", { bubbles: true }));
form.requestSubmit(button);
} finally {
form.remove();
}
})();
</script>
</body>
</html>Resultado
invalid set: Ada input: Ada submit: save
Guarda el ejemplo como archivo HTML y ábrelo en un navegador. Abre la consola y recarga la página. La primera solicitud registra `invalid`. Después de `set: Ada`, solo el evento despachado manualmente produce `input: Ada`; la segunda solicitud registra `submit: save`, pero el escuchador cancela el envío.
Lecciones relacionadas
- JavaScript · Lección 15 · Avanzado · Versión: 4
Fuentes
- HTML Standard — Form submission algorithm
- HTML Standard — Constraints: Security
- HTMLFormElement: submit event
- Element: input event
- HTMLElement: change event
- HTMLFormElement: requestSubmit() method
- HTMLFormElement: submit() method
- Event: currentTarget property
- Event: preventDefault() method
- EventTarget: dispatchEvent() method