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