CKTIS / JavaScript
HTMLButtonElement.form — o formulário associado a um botão
A propriedade só de leitura HTMLButtonElement.form devolve o HTMLFormElement associado a um botão ou null. Identifica o formulário efetivo, não o valor de texto do atributo form.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
button.formHTMLButtonElement.form, lido como button.form, devolve o formulário proprietário do botão: um objeto HTMLFormElement ou null quando não existe associação. Verifique se o valor é null antes de aceder às propriedades do formulário.
Por predefinição, um botão pertence ao formulário antecessor mais próximo. O atributo form pode indicar o id de um formulário no mesmo documento, mesmo fora dessa hierarquia, e substituir a associação predefinida. button.getAttribute("form") lê o texto do atributo, não o objeto do formulário.
A propriedade é só de leitura: não atribua um valor a button.form. Altere o atributo form ou a posição do botão no DOM. O exemplo mostra a associação e a sua remoção. Esta é uma API do navegador definida por HTML, não uma funcionalidade da linguagem ECMAScript; a MDN considera-a amplamente disponível desde julho de 2015.
Exemplos
<!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>Resultado
true true profile true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.