The HTMLButtonElement interface provides properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <button> elements.
On this page
HTMLButtonElement
Instance properties
Inherits properties from its parent, HTMLElement.
-
HTMLButtonElement.accessKey -
A string indicating the single-character keyboard key to give access to the button.
-
HTMLButtonElement.autofocus -
A boolean value indicating whether or not the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form-associated element in a document can have this attribute specified.
-
HTMLButtonElement.disabled -
A boolean value indicating whether or not the control is disabled, meaning that it does not accept any clicks.
HTMLButtonElement.formRead only-
An
HTMLFormElementreflecting the form that this button is associated with. If the button is a descendant of a form element, then this attribute is a reference to that form's associatedHTMLFormElement. If the button is not a descendant of a form element, then the attribute can be a reference to anyHTMLFormElementelement in the same document it is related to, or thenullvalue if none matches. -
HTMLButtonElement.formAction -
A string reflecting the URI of a resource that processes information submitted by the button. If specified, this attribute overrides the
actionattribute of the<form>element that owns this element. -
HTMLButtonElement.formEnctype -
A string reflecting the type of content that is used to submit the form to the server. If specified, this attribute overrides the
enctypeattribute of the<form>element that owns this element. -
HTMLButtonElement.formMethod -
A string reflecting the HTTP method that the browser uses to submit the form. If specified, this attribute overrides the
methodattribute of the<form>element that owns this element. -
HTMLButtonElement.formNoValidate -
A boolean value indicating that the form is not to be validated when it is submitted. If specified, this attribute overrides the
novalidateattribute of the<form>element that owns this element. -
HTMLButtonElement.formTarget -
A string reflecting a name or keyword indicating where to display the response that is received after submitting the form. If specified, this attribute overrides the
targetattribute of the<form>element that owns this element. HTMLButtonElement.labelsRead only-
A
NodeListthat represents a list of<label>elements that are labels for this button. HTMLButtonElement.menuExperimental-
A
HTMLMenuElementrepresenting the menu element to be displayed if the button is clicked and is oftype="menu". -
HTMLButtonElement.name -
A string representing the name of the object when submitted with a form. If specified, it must not be the empty string.
-
HTMLButtonElement.popoverTargetAction -
Gets and sets the action to be performed (
"hide","show", or"toggle") on a popover element being controlled by a control button. It reflects the value of thepopovertargetactionHTML attribute. -
HTMLButtonElement.popoverTargetElement -
Gets and sets the popover element to control via a button. The JavaScript equivalent of the
popovertargetHTML attribute. -
HTMLButtonElement.tabIndex -
A
longthat represents this element's position in the tabbing order. -
HTMLButtonElement.type -
A string indicating the behavior of the button. This is an enumerated attribute with the following possible values:
submit: The button submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value.reset: The button resets the form.button: The button does nothing.menu: The button displays a menu. Experimental
HTMLButtonElement.willValidateRead only-
A boolean value indicating whether the button is a candidate for constraint validation. It is
falseif any conditions bar it from constraint validation, including: itstypeproperty isresetorbutton; it has a<datalist>ancestor; or thedisabledproperty is set totrue. HTMLButtonElement.validationMessageRead only-
A string representing the localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation (
willValidateisfalse), or it satisfies its constraints. HTMLButtonElement.validityRead only-
A
ValidityStaterepresenting the validity states that this button is in. -
HTMLButtonElement.value -
A string representing the current form control value of the button.
Instance methods
Inherits methods from its parent, HTMLElement.
Specifications
| Specification |
|---|
| HTML Standard # htmlbuttonelement |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
HTMLButtonElement |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | ≤37 | 18 | 4 | ≤12.1 | 1 | 1.0 |
checkValidity |
4 | 12 | 4 | 10 | ≤12.1 | 5 | ≤37 | 18 | 4 | ≤12.1 | 5 | 1.0 |
disabled |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
form |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
formAction |
9 | 12 |
4In Firefox 56, the implementation has been updated so that theformAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
|
10 | ≤12.1 | 5.1 | 3 | 18 |
4In Firefox 56, the implementation has been updated so that theformAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
|
≤12.1 | 5 | 1.0 |
formEnctype |
9 | 12 | 4 | 10 | ≤12.1 | 5.1 | 3 | 18 | 4 | ≤12.1 | 5 | 1.0 |
formMethod |
9 | 12 | 4 | 10 | ≤12.1 | 5.1 | 3 | 18 | 4 | ≤12.1 | 5 | 1.0 |
formNoValidate |
4 | 12 | 4 | 10 | ≤12.1 | 5 | ≤37 | 18 | 4 | ≤12.1 | 4 | 1.0 |
formTarget |
9 | 12 | 4 | 10 | ≤12.1 | 5.1 | 3 | 18 | 4 | ≤12.1 | 5 | 1.0 |
labels |
6 | 18 | 56 | No | ≤12.1 | 5.1 | 3 | 18 | 56 | ≤12.1 | 5 | 1.0 |
name |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
popoverTargetAction |
114 | 114 | 114 | No | 100 | 17 | 114 | 114 | No | No | 17 | No |
popoverTargetElement |
114 | 114 | 114 | No | 100 | 17 | 114 | 114 | No | No | 17 | No |
reportValidity |
40 | 17 | 49 | No | 27 | 10.1 | 40 | 40 | 64 | 27 | 10.3 | 4.0 |
setCustomValidity |
4 | 12 | 4 | 10 | ≤12.1 | 5 | ≤37 | 18 | 4 | ≤12.1 | 5 | 1.0 |
type |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
validationMessage |
5 | 12 | 4 | 10 | ≤12.1 | 5 | ≤37 | 18 | 4 | ≤12.1 | 4 | 1.0 |
validity |
4 | 12 | 4 | 10 | ≤12.1 | 5 | ≤37 | 18 | 4 | ≤12.1 | 4 | 1.0 |
value |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
willValidate |
2 | 12 | 4 | 10 | ≤12.1 | 4 | ≤37 | 18 | 4 | ≤12.1 | 3 | 1.0 |
See also
- HTML element implementing this interface:
<button>
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLButtonElement