HTMLButtonElement

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 objet Element 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.form Lecture seule

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.

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.

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.

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.

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.

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.

HTMLButtonElement.labels Lecture seule

Un objet NodeList 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 HTML 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.

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

HTMLButtonElement.validationMessage Lecture 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.validity Lecture seule

Un ValidityState 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()

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

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.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML implémentant cette interface : <button>