Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

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

Fuentes