HTMLButtonElement

Proprits d'instance

Hrite des proprits de son parent, HTMLElement.

HTMLButtonElement.command

Une chane de caractres indiquant l'action effectuer sur un lment contrl par ce bouton.

HTMLButtonElement.commandForElement

Une rfrence un objet Element existant que le bouton contrle.

HTMLButtonElement.disabled

Un boolen indiquant si le contrle est dsactiv, c'est--dire qu'il n'accepte pas les clics.

HTMLButtonElement.form Lecture seule

Un objet HTMLFormElement reprsentant le formulaire auquel ce bouton est associ. Si le bouton est un descendant d'un lment formulaire, cet attribut est une rfrence l'HTMLFormElement associ ce formulaire. Si le bouton n'est pas un descendant d'un lment formulaire, l'attribut peut tre une rfrence n'importe quel lment HTMLFormElement du mme document auquel il est li, ou la valeur nulle (null) si aucun ne correspond.

HTMLButtonElement.formAction

Une chane de caractres reprsentant l'URI d'une ressource qui traite les informations soumises par le bouton. Si dfini, cet attribut remplace l'attribut action de l'lment HTML <form> qui possde ce bouton.

HTMLButtonElement.formEnctype

Une chane de caractres reprsentant le type de contenu utilis pour soumettre le formulaire au serveur. Si dfini, cet attribut remplace l'attribut enctype de l'lment HTML <form> qui possde ce bouton.

HTMLButtonElement.formMethod

Une chane de caractres reprsentant la mthode HTTP utilise par le navigateur pour soumettre le formulaire. Si dfini, cet attribut remplace l'attribut method de l'lment HTML <form> qui possde ce bouton.

HTMLButtonElement.formNoValidate

Un boolen indiquant que le formulaire ne doit pas tre valid lors de sa soumission. Si dfini, cet attribut remplace l'attribut novalidate de l'lment HTML <form> qui possde ce bouton.

HTMLButtonElement.formTarget

Une chane de caractres reprsentant un nom ou un mot-cl indiquant o afficher la rponse reue aprs la soumission du formulaire. Si dfini, cet attribut remplace l'attribut target de l'lment HTML <form> qui possde ce bouton.

HTMLButtonElement.interestForElement

Obtient ou dfinit l'lment cible d'un invocateur d'intrt, dans les cas o l'lment HTML <button> associ est dfini comme un invocateur d'intrt.

HTMLButtonElement.labels Lecture seule

Un objet NodeList reprsentant une liste d'lments <label> qui sont des tiquettes pour ce bouton.

HTMLButtonElement.name

Une chane de caractres reprsentant le nom de l'objet lors de la soumission avec un formulaire. Si dfini, il ne doit pas tre une chane vide.

HTMLButtonElement.popoverTargetAction

Obtient et dfinit l'action effectuer ("hide", "show" ou "toggle") sur un lment de fentre contextuelle (popover en anglais) contrl par un bouton de contrle. Cela reflte la valeur de l'attribut HTML popovertargetaction.

HTMLButtonElement.popoverTargetElement

Obtient et dfinit l'lment de fentre contextuelle (popover en anglais) contrler via un bouton. L'quivalent JavaScript de l'attribut HTML popovertarget.

HTMLButtonElement.type

Une chane de caractres indiquant le comportement du bouton. Il s'agit d'un attribut numr avec les valeurs possibles suivantes :

• submit : Le bouton soumet le formulaire. C'est la valeur par dfaut si l'attribut n'est pas dfini, ou s'il est modifi dynamiquement en une valeur vide ou invalide.
• reset : Le bouton rinitialise le formulaire.
• button : Le bouton n'a pas d'action.
• menu : Le bouton affiche un menu.

HTMLButtonElement.willValidate Lecture seule

Un boolen indiquant si le bouton est candidat la validation de contraintes. Il est false si certaines conditions l'empchent d'tre valid, notamment : sa proprit type est reset ou button ; il a un anctre <datalist> ; ou la proprit disabled est true.

HTMLButtonElement.validationMessage Lecture seule

Une chane de caractres reprsentant le message localis dcrivant les contraintes de validation non satisfaites (le cas chant). Cet attribut est une chane vide si le contrle n'est pas candidat la validation de contraintes (willValidate est false), ou s'il satisfait ses contraintes.

HTMLButtonElement.validity Lecture seule

Un ValidityState reprsentant les tats de validit de ce bouton.

HTMLButtonElement.value

Une chane de caractres reprsentant la valeur actuelle du contrle de formulaire du bouton.

Mthodes d'instance

Hrite des mthodes de son parent, HTMLElement.

HTMLButtonElement.checkValidity()

Retourne true si la valeur de l'lment ne prsente aucun problme de validit ; sinon, retourne false.

HTMLButtonElement.reportValidity()

Effectue la mme action que checkValidity(), mais signale galement le rsultat l'utilisateurice si l'vnement invalid n'a pas t annul.

HTMLButtonElement.setCustomValidity()

Dfinit le message de validit personnalis pour l'lment. Utilisez la chane vide pour indiquer que l'lment n'a pas d'erreur de validit personnalise.

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'lment HTML implmentant cette interface : <button>