HTMLButtonElement

Baseline Widely available *

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'interfaceHTMLButtonElement fournit des propriétés et des méthodes (en plus de l'interface régulièreHTMLElement dont elle hérite) pour manipuler les éléments HTML<button>.

Propriétés d'instance

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 objetElement existant que le bouton contrôle.

HTMLButtonElement.disabled

Un booléen indiquant si le contrôle est désactivé, c'est-à-dire qu'il n'accepte pas les clics.

HTMLButtonElement.formLecture seule

Un objetHTMLFormElement 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émentHTMLFormElement du même document auquel il est lié, ou la valeur nulle (null) si aucun ne correspond.

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'attributaction de l'élément HTML<form> qui possède ce bouton.

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'attributenctype de l'élément HTML<form> qui possède ce bouton.

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'attributmethod de l'élément HTML<form> qui possède ce bouton.

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'attributnovalidate de l'élément HTML<form> qui possède ce bouton.

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'attributtarget de l'élément HTML<form> qui possède ce bouton.

HTMLButtonElement.interestForElementExpérimental Non standard

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 uninvocateur d'intérêt.

HTMLButtonElement.labelsLecture seule

Un objetNodeList représentant une liste d'éléments<label> qui sont des étiquettes pour ce bouton.

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

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

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 : Le bouton soumet le formulaire. C'est la valeur par défaut si l'attribut n'est pas défini, ou s'il est modifié dynamiquement en une valeur vide ou invalide.
reset : Le bouton réinitialise le formulaire.
button : Le bouton n'a pas d'action.
menu : Le bouton affiche un menu.Expérimental

HTMLButtonElement.willValidateLecture seule

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 estreset oubutton ; il a un ancêtre<datalist> ; ou la propriétédisabled est àtrue.

HTMLButtonElement.validationMessageLecture seule

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.

HTMLButtonElement.validityLecture seule

UnValidityState représentant les états de validité de ce bouton.

HTMLButtonElement.value

Une chaîne de caractères représentant la valeur actuelle du contrôle de formulaire du bouton.

Méthodes d'instance

Hérite des méthodes de son parent,HTMLElement.

HTMLButtonElement.checkValidity(): Retournetrue si la valeur de l'élément ne présente aucun problème de validité ; sinon, retournefalse.
HTMLButtonElement.reportValidity(): Effectue la même action quecheckValidity(), mais signale également le résultat à l'utilisateur·ice si l'événementinvalid n'a pas été annulé.
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'apas d'erreur de validité personnalisée.