CKTIS / JavaScript
HTMLButtonElement.form — el formulario asociado a un botón
La propiedad de solo lectura HTMLButtonElement.form devuelve el HTMLFormElement asociado a un botón o null. Identifica el formulario real, no el valor de texto del atributo form.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
button.formHTMLButtonElement.form, leído como button.form, devuelve el formulario propietario del botón: un objeto HTMLFormElement o null si no existe una asociación. Comprueba si el resultado es null antes de acceder a las propiedades del formulario.
De forma predeterminada, un botón pertenece al formulario antecesor más cercano. El atributo form puede indicar el id de un formulario del mismo documento, incluso fuera de esa jerarquía, y reemplazar la asociación predeterminada. button.getAttribute("form") lee el texto del atributo, no el objeto del formulario.
La propiedad es de solo lectura: no asignes un valor a button.form. Cambia el atributo form o la posición del botón en el DOM. El ejemplo muestra la asociación y cómo eliminarla. Esta es una API del navegador definida por HTML, no una característica del lenguaje ECMAScript; MDN la considera ampliamente disponible desde julio de 2015.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.