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