HTMLButtonElement

  L'interface   HTMLButtonElement  fournit des propriétés et des méthodes (au-delà de l'interface d'objet <button> dont elle dispose également par héritage) pour manipuler la présentation et la présentation des éléments de bouton.

Propriétés

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

HTMLButtonElement.accessKey
Est un DOMString indiquant la touche de clavier à caractère unique permettant d'accéder au bouton.
HTMLButtonElement.autofocus
Est un Boolean (en-US) indiquant si le contrôle doit avoir ou non le focus d'entrée lors du chargement de la page, sauf si l'utilisateur le remplace, par exemple en tapant un contrôle différent. Cet attribut est spécifié pour un seul élément associé à un formulaire dans un document.
HTMLButtonElement.disabled (en-US)
Est un Boolean (en-US) indiquant si le contrôle est désactivé ou non, ce qui signifie qu'il n'accepte aucun clic .
HTMLButtonElement.form Lecture seule
Est un HTMLFormElement reflétant le formulaire auquel ce bouton est associé. Si le bouton est un descendant d'un élément de formulaire, cet attribut est l'ID de cet élément de formulaire.
Si le bouton n'est pas un descendant d'un élément de formulaire, l'attribut peut être l'identifiant de n'importe quel élément de formulaire dans le même document auquel il est lié, ou la valeur null si aucun élément ne correspond
.
HTMLButtonElement.formAction
Est un DOMString reflétant l'URI d'une ressource qui traite les informations soumises par le bouton. S'il est spécifié, cet attribut remplace l'attribut action de l'élément <form> à qui appartient cet élément.
HTMLButtonElement.formEnctype
Est un DOMString reflétant le type de contenu utilisé pour soumettre le formulaire au serveur. S'il est spécifié, cet attribut remplace l'attribut enctype de l'élément <form> à qui appartient cet élément.
HTMLButtonElement.formMethod
Est un DOMChaine reflétant la méthode HTTP que le navigateur utilise pour soumettre le formulaire. S'il est spécifié, cet attribut remplace l'attribut méthode de l'élément <form> à qui appartient cet élément.
HTMLButtonElement.formNoValidate
Est un Boolean (en-US) indiquant que le formulaire ne doit pas être validé lors de sa soumission. S'il est spécifié, cet attribut remplace l'attribut novalidate de l'élément <form> à qui appartient cet élément.
HTMLButtonElement.formTarget
Est un DOMChaîne reflétant un nom ou un mot clé indiquant où afficher la réponse reçue après la soumission du formulaire. S'il est spécifié, cet attribut remplace l'attribut target de l'élément <form> à qui appartient cet élément.
HTMLButtonElement.labels Lecture seule
Est un NodeList qui représente une liste d'éléments <label> qui sont des étiquettes pour ce bouton.
HTMLButtonElement.menu
Est-ce un HTMLMenuElement (en-US) représentant l'élément de menu à afficher si le bouton est cliqué et de type = "menu".
HTMLButtonElement.name
Est un DOMString représentant le nom de l'objet lorsqu'il est soumis avec un formulaire. HTML5 Si spécifié, il ne doit pas s'agir d'une chaîne vide.
HTMLButtonElement.tabIndex
Est un  long qui représente la position de cet élément dans l'ordre de tabulation .
HTMLButtonElement.type
: Est un DOMString indiquant le comportement du bouton. C'est un attribut énuméré avec les valeurs possibles suivantes:
  • "submit": Le bouton soumet le formulaire. Il s'agit de la valeur par défaut si l'attribut n'est pas spécifié, HTML5 ou s'il est modifié dynamiquement en une valeur vide ou non valide.
  • "reset": Le bouton réinitialise le formulaire.
  • "button": Le bouton ne fait rien.
  • "menu": Le bouton affiche un menu.
HTMLButtonElement.validationMessage Lecture seule
Est un DOMString représentant le message localisé décrivant les contraintes de validation que le contrôle ne satisfait pas (le cas échéant). Cet attribut est la chaîne vide si le contrôle n'est pas candidat à la validation de contrainte (willValidate est false) ou s'il respecte ses contraintes.
HTMLButtonElement.validity Lecture seule
Est un ValidityState (en-US) représentant les états de validité dans lesquels se trouve ce bouton.
HTMLButtonElement.value
Est un DOMString représentant la valeur de contrôle de formulaire actuelle du bouton.
HTMLButtonElement.willValidate Lecture seule
Est un Boolean (en-US) indiquant si le bouton est candidat à la validation de contrainte. Il est  false si des conditions l'empêchent de valider la contrainte .

Les méthodes

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

Nom Type de retour Description
checkValidity() Boolean (en-US)

Non pris en charge pour les éléments de bouton.

setCustomValidity(in DOMString error)

void Non pris en charge pour les éléments de bouton.

Avec un navigateur basé sur Gecko, utilisez la pseudo-classe : - moz-submit-invalid pour styler les boutons de soumission en fonction de la validation d'un formulaire.

Spécifications

Spécification Statut Commentaire
HTML Living Standard
La définition de 'HTMLButtonElement' dans cette spécification.
Standard évolutif L'attribut suivant a été ajouté : menu.
L'attribut  type peut prendre une valeur supplémentaire , "menu".
HTML5
La définition de 'HTMLButtonElement' dans cette spécification.
Recommendation Les attributs  tabindex et accesskeysont maintenant définis sur HTMLElement.
Les attributs suivants ont été ajoutés : autofocus, formAction, formEnctype, formMethod, formNoValidate, formTarget, labels, validity, validationMessage, and willValidate.
Les méthodes suivantes ont été ajoutées : checkValidity(), setCustomValidity().
The type attribute is no more read-only.
Document Object Model (DOM) Level 2 HTML Specification
La définition de 'HTMLButtonElement' dans cette spécification.
Obsolete Aucun changement de  Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification
La définition de 'HTMLButtonElement' dans cette spécification.
Obsolete . Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir également

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