Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLButtonElement.form — le formulaire associé à un bouton

La propriété en lecture seule HTMLButtonElement.form renvoie le HTMLFormElement associé à un bouton, ou null. Elle désigne le formulaire réel, et non la valeur textuelle de l’attribut form.

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

HTMLButtonElement.form, lu avec button.form, renvoie le formulaire propriétaire du bouton : un objet HTMLFormElement, ou null en l’absence d’association. Vérifiez que la valeur n’est pas null avant d’accéder aux propriétés du formulaire.

Par défaut, un bouton appartient au formulaire ancêtre le plus proche. L’attribut form peut désigner l’id d’un formulaire du même document, même si celui-ci n’est pas dans cette hiérarchie, et remplacer l’association par défaut. button.getAttribute("form") lit le texte de l’attribut, pas l’objet formulaire.

Cette propriété est en lecture seule : n’affectez pas de valeur à button.form. Modifiez plutôt l’attribut form ou la position du bouton dans le DOM. L’exemple montre l’association et sa suppression. Il s’agit d’une API de navigateur définie par HTML, et non d’une fonctionnalité du langage ECMAScript ; MDN la considère largement disponible depuis juillet 2015.

Exemples

<!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>

Résultat

true
true
profile
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources