KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onformdata — het samenstellen van formuliergegevens afhandelen

Het attribuut onformdata definieert een handler voor de gebeurtenis formdata. Hiermee kun je formuliergegevens bekijken en wijzigen nadat de lijst met items is samengesteld, zowel tijdens het verzenden van het formulier als bij het aanroepen van new FormData(form).

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

Syntax

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

onformdata is een event-handlercontentattribuut voor formdata. Hoewel het beschikbaar is op HTML-elementen, wordt het meestal gebruikt op het formulier waar deze gebeurtenis ontstaat. De waarde is JavaScript-code, geen Booleaanse waarde. De bijbehorende JavaScript-eigenschap form.onformdata accepteert een functie; een alternatief is form.addEventListener('formdata', handler).

De gebeurtenis treedt op nadat de itemlijst van het formulier is samengesteld, onder meer tijdens het verzenden en via new FormData(form). Het event-object is een FormDataEvent, en event.formData biedt de verzamelde gegevens als FormData. Met de methoden set(), append() en delete() kun je die gegevens wijzigen. Tijdens het verzenden zijn deze wijzigingen van invloed op de verzonden gegevensset, maar veranderen ze de waarden van de formuliervelden niet.

Verwar formdata niet met submit: new FormData(form) aanroepen verzendt het formulier niet. De gebeurtenis formdata bubbelt, maar kan niet worden geannuleerd; preventDefault() stopt het verzenden niet. Gebruik een handler voor submit om het verzenden te annuleren.

Het voorbeeld stelt gegevens samen zonder het formulier te verzenden. De code in onformdata voegt het item source toe voordat de constructor het resultaat teruggeeft. Een Content Security Policy kan handlers in attributen blokkeren; gebruik in dat geval addEventListener() in een toegestaan script.

Voorbeelden

<!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>

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen