CKTIS / HTML
onformdata — gestione della creazione dei dati del modulo
L’attributo onformdata definisce un gestore per l’evento formdata. Consente di esaminare e modificare i dati del modulo dopo la creazione dell’elenco di voci, sia durante l’invio del modulo sia quando si chiama new FormData(form).
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata è un attributo di contenuto per la gestione dell’evento formdata. Sebbene sia disponibile sugli elementi HTML, si usa di solito sul modulo da cui ha origine questo evento. Il suo valore è codice JavaScript, non un valore booleano. La proprietà JavaScript corrispondente, form.onformdata, accetta una funzione; in alternativa, si può usare form.addEventListener('formdata', handler).
L’evento si attiva dopo la creazione dell’elenco di voci del modulo, anche durante l’invio e tramite new FormData(form). L’oggetto event è un FormDataEvent e event.formData espone i dati raccolti come FormData. I metodi set(), append() e delete() consentono di modificarli. Durante l’invio, queste modifiche influiscono sui dati inviati, ma non cambiano i valori dei controlli del modulo.
Non confondere formdata con submit: chiamare new FormData(form) non invia il modulo. L’evento formdata si propaga agli elementi antenati, ma non è annullabile; preventDefault() non interrompe l’invio. Per annullare l’invio, gestisci invece submit.
L’esempio crea i dati senza inviare il modulo. Il codice in onformdata aggiunge la voce source prima che il costruttore restituisca il risultato. Una Content Security Policy può bloccare i gestori definiti negli attributi; in tal caso, usa addEventListener() in uno script consentito.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onformdata demo</title>
<form id="demo" onformdata="event.formData.set('source', 'demo')">
<input type="hidden" name="topic" value="html">
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const data = new FormData(form);
document.getElementById('result').textContent =
JSON.stringify(Array.from(data.entries()));
</script>
</html>Risultato
[["topic","html"],["source","demo"]]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.