KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLButtonElement.form — het formulier dat bij een knop hoort

De alleen-lezen eigenschap HTMLButtonElement.form retourneert het HTMLFormElement dat bij een knop hoort, of null. De eigenschap verwijst naar het daadwerkelijke formulier, niet naar de tekstwaarde van het form-attribuut.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

button.form

HTMLButtonElement.form, gelezen als button.form, retourneert de formuliereigenaar van de knop: een HTMLFormElement-object, of null als er geen koppeling is. Controleer op null voordat je de eigenschappen van het formulier gebruikt.

Standaard hoort een knop bij het dichtstbijzijnde bovenliggende formulier. Het form-attribuut kan de id aangeven van een formulier in hetzelfde document, ook buiten die bovenliggende structuur, en de standaardkoppeling vervangen. button.getAttribute("form") leest de attribuuttekst, niet het formulierobject.

De eigenschap is alleen-lezen: wijs geen waarde toe aan button.form. Wijzig in plaats daarvan het form-attribuut of de DOM-positie van de knop. Het voorbeeld laat de koppeling en het verwijderen ervan zien. Dit is een browser-API die door HTML is gedefinieerd, geen functie van de ECMAScript-taal; MDN vermeldt dat deze sinds juli 2015 breed beschikbaar is.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Button form owner</title>
<form id="profile"></form>
<button type="button" id="save">Save</button>
<script>
  const button = document.getElementById("save");
  const form = document.getElementById("profile");

  console.log(button.form === null);
  button.setAttribute("form", "profile");
  console.log(button.form === form);
  console.log(button.getAttribute("form"));
  button.removeAttribute("form");
  console.log(button.form === null);
</script>
</html>

Resultaat

true
true
profile
true

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