Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

  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 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
Est un Boolean 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 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 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 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 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

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.

Specifications

Specification Status Comment
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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
HTMLButtonElementChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
accessKeyChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
autofocusChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
disabledChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formChrome Support complet OuiEdge Support complet 16Firefox Support complet 4IE Aucun support NonOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formActionChrome Support complet OuiEdge Support complet 12Firefox Support complet 4
Notes
Support complet 4
Notes
Notes In Firefox 56, the implementation has been updated so that the formAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4
Notes
Support complet 4
Notes
Notes In Firefox 56, the implementation has been updated so that the formAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formEnctypeChrome Support complet OuiEdge Support complet 12Firefox Support complet 4IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formMethodChrome Support complet OuiEdge Support complet 12Firefox Support complet 4IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formNoValidateChrome Support complet OuiEdge Support complet 12Firefox Support complet 4IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
formTargetChrome Support complet OuiEdge Support complet 12Firefox Support complet 4IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
labelsChrome Support complet OuiEdge Support complet 18Firefox Support complet 56IE ? Opera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 56Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
menu
Expérimentale
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support NonIE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
nameChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
reportValidityChrome Support complet 40Edge Support complet 17Firefox Support complet 49IE Aucun support NonOpera Support complet 27Safari Support complet 10WebView Android Support complet 40Chrome Android Support complet 40Firefox Android Support complet 64Opera Android Support complet 27Safari iOS Support complet 10Samsung Internet Android Support complet 4.0
tabIndexChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
typeChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
validationMessageChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
validityChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
valueChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
willValidateChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir également

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

Étiquettes et contributeurs liés au document

Contributeurs à cette page : mdnwebdocs-bot, dragon38800, fscholz
Dernière mise à jour par : mdnwebdocs-bot,