CKTIS / HTML
onformdata — spracovanie vytvárania údajov formulára
Atribút onformdata definuje obslužnú funkciu udalosti formdata. Umožňuje prezerať a upravovať údaje formulára po zostavení zoznamu položiek, a to pri odosielaní formulára aj pri volaní new FormData(form).
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata je obsahový atribút obslužnej funkcie udalosti formdata. Hoci je dostupný na elementoch HTML, zvyčajne sa používa na formulári, v ktorom táto udalosť vzniká. Jeho hodnota je kód JavaScriptu, nie logická hodnota. Zodpovedajúca vlastnosť JavaScriptu form.onformdata prijíma funkciu; alternatívou je form.addEventListener('formdata', handler).
Udalosť sa vyvolá po zostavení zoznamu položiek formulára, okrem iného pri odosielaní a prostredníctvom new FormData(form). Objekt event je typu FormDataEvent a event.formData sprístupňuje zhromaždené údaje ako FormData. Metódy set(), append() a delete() umožňujú tieto údaje upravovať. Pri odosielaní zmeny ovplyvnia odosielanú súpravu údajov, ale nezmenia hodnoty ovládacích prvkov formulára.
Nezamieňajte formdata s submit: volanie new FormData(form) samo osebe formulár neodošle. Udalosť formdata sa šíri k predkom, ale nedá sa zrušiť; preventDefault() odosielanie nezastaví. Ak chcete odosielanie zrušiť, spracujte udalosť submit.
Príklad vytvorí údaje bez odoslania formulára. Kód v onformdata pridá položku source skôr, než konštruktor vráti výsledok. Content Security Policy môže blokovať obslužné funkcie uvedené v atribútoch; v takom prostredí použite addEventListener() v povolenom skripte.
Príklady
<!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>Výsledok
[["topic","html"],["source","demo"]]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.