CKTIS / HTML
onformdata — obravnavanje ustvarjanja podatkov obrazca
Atribut onformdata določa obravnavo dogodka formdata. Omogoča pregled in spreminjanje podatkov obrazca po sestavi seznama vnosov, tako med pošiljanjem obrazca kot ob klicu new FormData(form).
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata je vsebinski atribut za obravnavo dogodka formdata. Čeprav je na voljo na elementih HTML, se običajno uporablja na obrazcu, v katerem ta dogodek nastane. Njegova vrednost je koda JavaScript, ne logična vrednost. Ustrezna lastnost JavaScript form.onformdata sprejme funkcijo; druga možnost je form.addEventListener('formdata', handler).
Dogodek se sproži po sestavi seznama vnosov obrazca, med drugim med pošiljanjem in prek new FormData(form). Objekt event je vrste FormDataEvent, event.formData pa zbrane podatke izpostavi kot FormData. Metode set(), append() in delete() omogočajo spreminjanje teh podatkov. Med pošiljanjem spremembe vplivajo na poslani nabor podatkov, ne spremenijo pa vrednosti kontrolnikov obrazca.
Ne zamenjujte formdata z submit: klic new FormData(form) sam po sebi ne pošlje obrazca. Dogodek formdata se širi do prednikov, vendar ga ni mogoče preklicati; preventDefault() pošiljanja ne ustavi. Za preklic pošiljanja obravnavajte dogodek submit.
Primer ustvari podatke, ne da bi poslal obrazec. Koda v onformdata doda vnos source, preden konstruktor vrne rezultat. Content Security Policy lahko blokira obravnavo dogodkov, določeno v atributih; v takem okolju uporabite addEventListener() v dovoljenem skriptu.
Primeri
<!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>Rezultat
[["topic","html"],["source","demo"]]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.