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

* Some parts of this feature may have varying levels of support.

TheHTMLButtonElement interface provides properties and methods (beyond the regularHTMLElement interface it also has available to it by inheritance) for manipulating<button> elements.

Instance properties

Inherits properties from its parent,HTMLElement.

HTMLButtonElement.command

A string value indicating the action to be performed on an element being controlled by this button.

HTMLButtonElement.commandForElement

A reference to an existingElement that the button controls.

HTMLButtonElement.disabled

A boolean value indicating whether or not the control is disabled, meaning that it does not accept any clicks.

HTMLButtonElement.formRead only

AnHTMLFormElement reflecting 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 anyHTMLFormElement element in the same document it is related to, or thenull value 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 theaction attribute 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 theenctype attribute 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 themethod attribute 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 thenovalidate attribute of the<form> element that owns this element.

HTMLButtonElement.formTarget

A string reflecting a name or keyword indicating where to display the response received after submitting the form. If specified, this attribute overrides thetarget attribute of the<form> element that owns this element.

HTMLButtonElement.labelsRead only

ANodeList that represents a list of<label> elements that are labels for this button.

HTMLButtonElement.name

A string representing the object's name 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 thepopovertargetaction HTML attribute.

HTMLButtonElement.popoverTargetElement

Gets and sets the popover element to control via a button. The JavaScript equivalent of thepopovertarget HTML attribute.

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 isfalse if any conditions bar it from constraint validation, including: itstype property isreset orbutton; it has a<datalist> ancestor; or thedisabled property 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 (willValidate isfalse), or it satisfies its constraints.

HTMLButtonElement.validityRead only

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

HTMLButtonElement.checkValidity(): Returnstrue if the element's value has no validity problems; otherwise, returnsfalse.
HTMLButtonElement.reportValidity(): Performs the same action ascheckValidity(), but also reports the result to the user if theinvalid event was not canceled.
HTMLButtonElement.setCustomValidity(): Sets the custom validity message for the element. Use the empty string to indicate that the element doesnot have a custom validity error.