Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onformdata — zpracování vytváření dat formuláře

Atribut onformdata definuje obslužnou funkci události formdata. Umožňuje prohlížet a upravovat data formuláře po sestavení seznamu položek, a to při odesílání formuláře i při volání new FormData(form).

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<form onformdata="event.formData.set('source', 'demo')">…</form>

onformdata je obsahový atribut obslužné funkce události formdata. Ačkoli je dostupný na elementech HTML, obvykle se používá na formuláři, ve kterém tato událost vzniká. Jeho hodnota je kód JavaScriptu, nikoli logická hodnota. Odpovídající vlastnost JavaScriptu form.onformdata přijímá funkci; alternativou je form.addEventListener('formdata', handler).

Událost se vyvolá po sestavení seznamu položek formuláře, mimo jiné při odesílání a prostřednictvím new FormData(form). Objekt event je typu FormDataEvent a event.formData zpřístupňuje shromážděná data jako FormData. Metody set(), append() a delete() umožňují tato data upravovat. Při odesílání změny ovlivní odesílanou sadu dat, ale nezmění hodnoty ovládacích prvků formuláře.

Nezaměňujte formdata s submit: volání new FormData(form) samo o sobě formulář neodešle. Událost formdata se šíří k předkům, ale nelze ji zrušit; preventDefault() odeslání nezastaví. Chcete-li odesílání zrušit, zpracujte událost submit.

Příklad vytvoří data, aniž by odeslal formulář. Kód v onformdata přidá položku source před tím, než konstruktor vrátí výsledek. Content Security Policy může blokovat obslužné funkce uvedené v atributech; v takovém prostředí použijte addEventListener() v povoleném skriptu.

Pří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ýsledek

[["topic","html"],["source","demo"]]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje