Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLButtonElement.form — formulář přiřazený k tlačítku

Vlastnost HTMLButtonElement.form pouze pro čtení vrací objekt HTMLFormElement přiřazený k tlačítku, nebo null. Označuje skutečný formulář, nikoli textovou hodnotu atributu form.

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

Syntaxe

button.form

HTMLButtonElement.form, čtená jako button.form, vrací vlastníka formuláře tlačítka: objekt HTMLFormElement, nebo null, pokud žádné přiřazení neexistuje. Než začnete přistupovat k vlastnostem formuláře, ověřte, že hodnota není null.

Tlačítko ve výchozím nastavení patří k nejbližšímu nadřazenému formuláři. Atribut form může určit id formuláře ve stejném dokumentu, i když není v této hierarchii, a nahradit výchozí přiřazení. button.getAttribute("form") čte text atributu, nikoli objekt formuláře.

Vlastnost je pouze pro čtení: nepřiřazujte hodnotu do button.form. Místo toho změňte atribut form nebo pozici tlačítka v DOM. Příklad ukazuje přiřazení a jeho odstranění. Jde o API prohlížeče definované standardem HTML, nikoli o vlastnost jazyka ECMAScript; MDN uvádí, že je široce dostupné od července 2015.

Příklady

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

Výsledek

true
true
profile
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje