CKTIS / HTML
onformdata — Verarbeitung beim Erstellen von Formulardaten
Das Attribut onformdata definiert einen Handler für das Ereignis formdata. Damit lassen sich Formulardaten prüfen und ändern, nachdem die Eintragsliste erstellt wurde – sowohl beim Absenden eines Formulars als auch beim Aufruf von new FormData(form).
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata ist ein Event-Handler-Content-Attribut für formdata. Obwohl es auf HTML-Elementen verfügbar ist, wird es üblicherweise auf dem Formular verwendet, auf dem dieses Ereignis ausgelöst wird. Sein Wert ist JavaScript-Code, kein boolescher Wert. Die entsprechende JavaScript-Eigenschaft form.onformdata nimmt eine Funktion entgegen; alternativ kann form.addEventListener('formdata', handler) verwendet werden.
Das Ereignis wird ausgelöst, nachdem die Eintragsliste des Formulars erstellt wurde, unter anderem beim Absenden und durch new FormData(form). Das event-Objekt ist vom Typ FormDataEvent, und event.formData stellt die gesammelten Daten als FormData bereit. Mit den Methoden set(), append() und delete() lassen sich diese Daten ändern. Beim Absenden wirken sich die Änderungen auf den übermittelten Datensatz aus, ändern aber nicht die Werte der Formularelemente.
Verwechsle formdata nicht mit submit: Der Aufruf von new FormData(form) sendet das Formular nicht selbst ab. Das Ereignis formdata bubbelt, ist aber nicht abbrechbar; preventDefault() verhindert das Absenden nicht. Verwende stattdessen einen Handler für submit, um das Absenden abzubrechen.
Das Beispiel erstellt Daten, ohne das Formular abzusenden. Der Code in onformdata fügt den Eintrag source hinzu, bevor der Konstruktor sein Ergebnis zurückgibt. Eine Content Security Policy kann Handler in Attributen blockieren; verwende in diesem Fall addEventListener() in einem zulässigen Skript.
Beispiele
<!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>Ergebnis
[["topic","html"],["source","demo"]]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.