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 méthodes (en plus de celles fournies par l'interfaceHTMLElement dont elle hérite) qui permettent de manipuler les éléments<button>.

Propriétés

Hérite des propriétés de son parent,HTMLElement.

HTMLButtonElement.accessKey

Une chaîne de caractères qui indique la touche du clavier (unique) qui donne accès à ce bouton.

HTMLButtonElement.autofocus

Un booléen qui indique si le contrôle devrait avoir le focus au chargement de la page, à moins que l'utilisatrice ou l'utilisateur passe outre, par exemple en saisissant dans un autre contrôle. Seul un élément du document, associé à un formulaire, peut avoir cet attribut.

HTMLButtonElement.disabled

Un booléen qui indique si le contrôle est désactivé, signifiant alors qu'il n'accepte aucun clic.

HTMLButtonElement.formLecture seule

Un objetHTMLFormElement qui reflète l'élément de formulaire auquel ce bouton est associé. Si le bouton est un descendant de l'élément du formulaire, cet attribut sera une référence à l'objetHTMLFormElement associé à ce formulaire. Si le bouton n'est pas un descendant de l'élément du formulaire, l'attribut peut être une référence à n'importe quel élémentHTMLFormElement associé du même document, ou la valeurnull si aucun ne correspond.

HTMLButtonElement.formAction

Une chaîne de caractères qui reflète l'URI d'une ressource qui traite les informations envoyées par ce bouton. S'il est présent, cet attribut surcharge l'attributaction de l'élément<form> auquel est associé cet élément.

HTMLButtonElement.formEnctype

Une chaîne de caractères qui reflète le type de contenu utilisé pour envoyer le formulaire au serveur. S'il est présent, cet attribut surcharge l'attributenctype de l'élément<form> auquel est associé cet élément.

HTMLButtonElement.formMethod

Une chaîne de caractères qui reflète la méthode HTTP utilisée par le navigateur pour envoyer le formulaire. S'il est présent, cet attribut surcharge l'attributmethod de l'élément<form> auquel est associé cet élément.

HTMLButtonElement.formNoValidate

Un booléen qui indique que le formulaire ne devrait pas être validé pour l'envoi. S'il est présent, cet attribut surcharge l'attributnovalidate de l'élément<form> auquel est associé cet élément.

HTMLButtonElement.formTarget

Une chaîne de caractères qui reflète le nom ou un mot-clé de l'emplacement où afficher la réponse reçue après l'envoi du formulaire. S'il est présent, cet attribut surcharge l'attributtarget de l'élément<form> auquel est associé cet élément.

HTMLButtonElement.labelsLecture seule

Un objetNodeList qui représente une liste des éléments<label> qui sont des libellés pour ce bouton.

HTMLButtonElement.menuExpérimental

Un objet HTMLMenuElement qui représente l'élément de menu à afficher si on clique sur ce bouton et qu'il atype="menu".

HTMLButtonElement.name

Une chaîne de caractères qui représente le nom de l'objet lorsqu'il est envoyé avec un formulaire. Si cet attribut est présent, sa valeur ne doit pas être la chaîne de caractères.

HTMLButtonElement.tabIndex

Une valeur numérique de typelong qui représente la position de cet élément au sein de l'ordre de tabulation.

HTMLButtonElement.type

Une chaîne de caractères qui indique le comportement du bouton. Il s'agit d'un attribut à valeur contrainte parmi une liste :

submit: Le bouton envoi le formulaire. Il s'agit de la valeur par défaut si l'attribut n'est pas indiqué ou s'il a été changé dynamiquement vers une valeur vide ou invalide.
reset: Le bouton réinitialise le formulaire.
button: Le bouton ne fait rien.
menu: Le bouton affiche un menu.Expérimental

HTMLButtonElement.willValidateLecture seule

Un booléen qui indique si le bouton est candidat à la validation de contraintes. Il vautfalse si une condition l'empêche de participer à la validation des contraintes, y compris si sa propriététype vautreset oubutton ; s'il a un ancêtre<datalist> ; ou si la propriétédisabled vauttrue.

HTMLButtonElement.validationMessageLecture seule

Une chaîne de caractères représentant le message localisé qui décrit la validation de contrainte lorsque le contrôle ne respecte pas les contraintes éventuelles. Cet attribut vaudra la chaîne vide si le contrôle n'est pas candidat à la validation de contraintes (willValidate àfalse), ou s'il respecte les contraintes.

HTMLButtonElement.validityLecture seule

Un objetValidityState représentant l'état de validité du bouton.

HTMLButtonElement.value

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

Méthodes

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

Nom	Valeur de retour	Description
`checkValidity()`	Booléen	Non prise en charge pour les éléments bouton ou de réinitialisation.
`reportValidity()`	Booléen	Non prise en charge pour les éléments bouton ou de réinitialisation.
`setCustomValidity(in DOMString error)`	`void`	Non prise en charge pour les éléments bouton ou de réinitialisation.

Pour les navigateurs utilisant Gecko, la pseudo-classe non standard:-moz-submit-invalid permet de mettre en forme les boutons d'envoi de formulaire selon la validation du formulaire.