Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Eventi `submit` e `input` nei moduli HTML

Usa `input` per reagire alle modifiche e `submit` per gestire l’invio del modulo nel momento giusto del processo di validazione.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();

input si attiva sul controllo modificato e risale l’albero DOM. In un listener sul modulo, event.target indica il controllo e event.currentTarget indica il modulo durante l’esecuzione del listener. Se un controllo esterno al modulo è associato tramite l’attributo form, l’associazione da sola non fa arrivare l’evento al modulo. Usa input per fornire riscontri durante la modifica; change segnala una modifica confermata, di solito quando un campo di testo perde il focus. Assegnare un valore a .value non attiva input da solo.

submit si attiva sul modulo, non sul pulsante. È un SubmitEvent che risale il DOM e può essere annullato. Ascoltalo al posto del click del pulsante per gestire anche l’invio implicito, per esempio con il tasto Invio quando il browser lo consente. event.submitter indica il pulsante di invio oppure vale null se nessun pulsante ha avviato l’invio. Per impedire l’invio predefinito, chiama event.preventDefault() nel listener prima di qualsiasi await.

form.requestSubmit() segue le normali regole di invio senza scegliere un pulsante. form.requestSubmit(button) usa quel pulsante e tiene conto delle sue impostazioni, come formaction e formnovalidate. Se la validazione dei vincoli non viene saltata e fallisce, i controlli non validi ricevono invalid e submit non si attiva. Passare un elemento che non è un pulsante di invio genera un TypeError; passare un pulsante di invio che non appartiene al modulo genera un NotFoundError.

Una chiamata diretta a form.submit() salta la validazione dei vincoli e non attiva submit. Un controllo con name o id uguale a submit può nascondere il metodo. La validazione nel browser non sostituisce quella sul server. Queste API appartengono alla piattaforma web, non a ECMAScript 2024; verifica il supporto nell’ambiente di destinazione.

Esempi

<!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>

Risultato

invalid
set: Ada
input: Ada
submit: save

Salva l’esempio come file HTML e aprilo in un browser. Apri la console e ricarica la pagina. La prima richiesta stampa `invalid`. Dopo `set: Ada`, solo l’evento inviato manualmente produce `input: Ada`; la seconda richiesta stampa `submit: save`, ma il listener annulla l’invio.

Lezioni correlate

  • JavaScript · Lezione 15 · Avanzato · Versione: 4

Fonti