HTMLButtonElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

Voir aussi

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