Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti