Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes