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.formHTMLButtonElement.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.