HTMLButtonElement
=================

L'interface **`HTMLButtonElement`** fournit des propriétés et méthodes (en plus de celles fournies par l'interface `HTMLElement` dont elle hérite) qui permettent de manipuler les éléments `<button>`.

EventTarget

Node

Element

HTMLElement

HTMLButtonElementProprié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.form` Lecture seule 

Un objet `HTMLFormElement` 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'objet `HTMLFormElement` 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ément `HTMLFormElement` associé du même document, ou la valeur `null` 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'attribut `action` 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'attribut `enctype` 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'attribut `method` 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'attribut `novalidate` 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'attribut `target` de l'élément `<form>` auquel est associé cet élément.

`HTMLButtonElement.labels` Lecture seule 

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

`HTMLButtonElement.menu` 
Expérimental

Un objet `HTMLMenuElement` (en-US) qui représente l'élément de menu à afficher si on clique sur ce bouton et qu'il a `type="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 type `long` 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.willValidate` Lecture seule 

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

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

Un objet `ValidityState` (en-US) 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.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # htmlbuttonelement |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément HTML qui porte cette interface : `<button>`