KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

form-attribuut — expliciete formulierkoppeling

Het form-attribuut bepaalt bij welk formulier een besturingselement hoort, ook als het buiten dat formulier staat. De waarde is de id van het formulier in dezelfde boom, niet de name of een CSS-selector.

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

Syntax

form="form-id"

Het attribuut form="form-id" bepaalt expliciet bij welk formulier een element hoort. De waarde moet overeenkomen met de id van een form-element in dezelfde boom; voeg geen # toe. De koppeling verplaatst het element niet in de DOM en maakt het mogelijk een besturingselement buiten het formulier te plaatsen.

Het attribuut wordt ondersteund door button, fieldset, input, object, output, select, textarea en aangepaste elementen die aan formulieren zijn gekoppeld. Het is geen globaal attribuut. De koppeling alleen betekent niet dat een element een waarde bijdraagt wanneer het formulier wordt verzonden: fieldset en output doen dat bijvoorbeeld niet.

Zonder dit attribuut hoort het element normaal gesproken bij het dichtstbijzijnde bovenliggende form-element. Wanneer de formulierkoppeling opnieuw wordt bepaald, wordt de ID uit het attribuut alleen opgezocht als het element met een document verbonden is. Als de zoekactie in dat geval geen formulier oplevert, blijft het element ongekoppeld in plaats van terug te vallen op het bovenliggende formulier. Een lege waarde herstelt dan de standaardkoppeling niet — verwijder het attribuut. In een deelboom die niet met het document verbonden is, kan het element nog steeds worden gekoppeld aan het dichtstbijzijnde bovenliggende form-element, ook als het attribuut geen formulier aanwijst. Gebruik unieke ID’s.

Het attribuut wordt niet overgeërfd: form instellen op een fieldset koppelt de besturingselementen daarin niet automatisch aan het opgegeven formulier. Ingebouwde elementen die dit attribuut ondersteunen, bieden een .form-eigenschap die het formulier of null teruggeeft. In het voorbeeld hoort de externe input bij order, staat deze in order.elements en draagt de waarde bij aan FormData(order).

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Explicit form association</title>
<form id="order"></form>
<label>Item <input id="item" name="item" value="book" form="order"></label>
<pre id="result"></pre>
<script>
  const order = document.getElementById('order');
  const item = document.getElementById('item');
  document.getElementById('result').textContent = [
    item.form === order,
    order.elements.namedItem('item') === item,
    new FormData(order).get('item')
  ].join('\n');
</script>
</html>

Resultaat

true
true
book

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