HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
View in English Always switch to English
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
L'interface HTMLButtonElement fournit des propriétés et des méthodes (en plus de l'interface régulière HTMLElement dont elle hérite) pour manipuler les éléments HTML <button>.
HTMLButtonElement
HTMLElement
<button>
Hérite des propriétés de son parent, HTMLElement.
HTMLButtonElement.command
Une chaîne de caractères indiquant l'action à effectuer sur un élément contrôlé par ce bouton.
HTMLButtonElement.commandForElement
Une référence à un objet Element existant que le bouton contrôle.
Element
HTMLButtonElement.disabled
Un booléen indiquant si le contrôle est désactivé, c'est-à-dire qu'il n'accepte pas les clics.
HTMLButtonElement.form
Un objet HTMLFormElement représentant le formulaire auquel ce bouton est associé. Si le bouton est un descendant d'un élément formulaire, cet attribut est une référence à l'HTMLFormElement associé à ce formulaire. Si le bouton n'est pas un descendant d'un élément formulaire, l'attribut peut être une référence à n'importe quel élément HTMLFormElement du même document auquel il est lié, ou la valeur nulle (null) si aucun ne correspond.
HTMLFormElement
null
HTMLButtonElement.formAction
Une chaîne de caractères représentant l'URI d'une ressource qui traite les informations soumises par le bouton. Si défini, cet attribut remplace l'attribut action de l'élément HTML <form> qui possède ce bouton.
action
<form>
HTMLButtonElement.formEnctype
Une chaîne de caractères représentant le type de contenu utilisé pour soumettre le formulaire au serveur. Si défini, cet attribut remplace l'attribut enctype de l'élément HTML <form> qui possède ce bouton.
enctype
HTMLButtonElement.formMethod
Une chaîne de caractères représentant la méthode HTTP utilisée par le navigateur pour soumettre le formulaire. Si défini, cet attribut remplace l'attribut method de l'élément HTML <form> qui possède ce bouton.
method
HTMLButtonElement.formNoValidate
Un booléen indiquant que le formulaire ne doit pas être validé lors de sa soumission. Si défini, cet attribut remplace l'attribut novalidate de l'élément HTML <form> qui possède ce bouton.
novalidate
HTMLButtonElement.formTarget
Une chaîne de caractères représentant un nom ou un mot-clé indiquant où afficher la réponse reçue après la soumission du formulaire. Si défini, cet attribut remplace l'attribut target de l'élément HTML <form> qui possède ce bouton.
target
HTMLButtonElement.interestForElement
Obtient ou définit l'élément cible d'un invocateur d'intérêt, dans les cas où l'élément HTML <button> associé est défini comme un invocateur d'intérêt.
HTMLButtonElement.labels
Un objet NodeList représentant une liste d'éléments <label> qui sont des étiquettes pour ce bouton.
NodeList
<label>
HTMLButtonElement.name
Une chaîne de caractères représentant le nom de l'objet lors de la soumission avec un formulaire. Si défini, il ne doit pas être une chaîne vide.
HTMLButtonElement.popoverTargetAction
Obtient et définit l'action à effectuer ("hide", "show" ou "toggle") sur un élément de fenêtre contextuelle (popover en anglais) contrôlé par un bouton de contrôle. Cela reflète la valeur de l'attribut HTML popovertargetaction.
"hide"
"show"
"toggle"
popovertargetaction
HTMLButtonElement.popoverTargetElement
Obtient et définit l'élément de fenêtre contextuelle (popover en anglais) à contrôler via un bouton. L'équivalent JavaScript de l'attribut HTML popovertarget.
popovertarget
HTMLButtonElement.type
Une chaîne de caractères indiquant le comportement du bouton. Il s'agit d'un attribut énuméré avec les valeurs possibles suivantes :
submit
reset
button
menu
HTMLButtonElement.willValidate
Un booléen indiquant si le bouton est candidat à la validation de contraintes. Il est à false si certaines conditions l'empêchent d'être validé, notamment : sa propriété type est reset ou button ; il a un ancêtre <datalist> ; ou la propriété disabled est à true.
false
type
<datalist>
disabled
true
HTMLButtonElement.validationMessage
Une chaîne de caractères représentant le message localisé décrivant les contraintes de validation non satisfaites (le cas échéant). Cet attribut est une chaîne vide si le contrôle n'est pas candidat à la validation de contraintes (willValidate est à false), ou s'il satisfait ses contraintes.
willValidate
HTMLButtonElement.validity
Un ValidityState représentant les états de validité de ce bouton.
ValidityState
HTMLButtonElement.value
Une chaîne de caractères représentant la valeur actuelle du contrôle de formulaire du bouton.
Hérite des méthodes de son parent, HTMLElement.
HTMLButtonElement.checkValidity()
Retourne true si la valeur de l'élément ne présente aucun problème de validité ; sinon, retourne false.
HTMLButtonElement.reportValidity()
Effectue la même action que checkValidity(), mais signale également le résultat à l'utilisateur·ice si l'événement invalid n'a pas été annulé.
checkValidity()
invalid
HTMLButtonElement.setCustomValidity()
Définit le message de validité personnalisé pour l'élément. Utilisez la chaîne vide pour indiquer que l'élément n'a pas d'erreur de validité personnalisée.
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.