WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLButtonElement.form — das einem Button zugeordnete Formular

Die schreibgeschützte Eigenschaft HTMLButtonElement.form gibt das dem Button zugeordnete HTMLFormElement oder null zurück. Sie bezeichnet das tatsächliche Formular, nicht den Textwert des form-Attributs.

Version: 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, gelesen als button.form, gibt den Formulareigentümer des Buttons zurück: ein HTMLFormElement-Objekt oder null, wenn keine Zuordnung besteht. Prüfe vor dem Zugriff auf Eigenschaften des Formulars, ob der Wert null ist.

Standardmäßig gehört ein Button zu seinem nächstgelegenen übergeordneten Formular. Das form-Attribut kann die id eines Formulars im selben Dokument angeben, auch außerhalb dieser Vorfahrenhierarchie, und die Standardzuordnung überschreiben. button.getAttribute("form") liest den Attributtext, nicht das Formularobjekt.

Die Eigenschaft ist schreibgeschützt: Weise button.form keinen Wert zu. Ändere stattdessen das form-Attribut oder die DOM-Position des Buttons. Das Beispiel zeigt die Zuordnung und deren Entfernung. Dies ist eine durch HTML definierte Browser-API, kein ECMAScript-Sprachmerkmal; MDN kennzeichnet sie seit Juli 2015 als breit verfügbar.

Beispiele

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

Ergebnis

true
true
profile
true

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.

Quellen