Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje