Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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