HTMLButtonElement
The HTMLButtonElement
interface provides properties and methods (beyond the regular HTMLElement
interface it also has available to it by inheritance) for manipulating <button>
elements.
Properties
Inherits properties from its parent, HTMLElement
.
-
Is a
DOMString
indicating the single-character keyboard key to give access to the button. -
Is 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.
-
Is a boolean value indicating whether or not the control is disabled, meaning that it does not accept any clicks.
-
Is an
HTMLFormElement
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. -
Is a
DOMString
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. -
Is a
DOMString
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. -
Is a
DOMString
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. -
Is a boolean value indicating that the form is not to be validated when it is submitted. If specified, this attribute overrides the
novalidate
attribute of the<form>
element that owns this element. -
Is a
DOMString
reflecting a name or keyword indicating where to display the response that is received after submitting the form. If specified, this attribute overrides thetarget
attribute of the<form>
element that owns this element. -
Is a
NodeList
that represents a list of<label>
elements that are labels for this button. -
Is a
HTMLMenuElement
representing the menu element to be displayed if the button is clicked and is oftype="menu"
. -
Is a
DOMString
representing the name of the object when submitted with a form. If specified, it must not be the empty string. -
Is a
long
that represents this element's position in the tabbing order. -
Is a
DOMString
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.
-
Is a boolean value indicating whether the button is a candidate for constraint validation. It is
false
if any conditions bar it from constraint validation, including: itstype
property isreset
orbutton
; it has a<datalist>
ancestor; or thedisabled
property is set totrue
. -
Is a
DOMString
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. -
Is a
ValidityState
representing the validity states that this button is in. -
Is a
DOMString
representing the current form control value of the button.
Methods
Inherits methods from its parent, HTMLElement
Name | Return Type | Description |
---|---|---|
checkValidity() |
A boolean value | Not supported for reset or button elements. |
reportValidity() |
A boolean value | Not supported for reset or button elements. |
setCustomValidity(in DOMString error) |
void |
Not supported for reset or button elements. |
With Gecko-based browser, use the :-moz-submit-invalid
pseudo-class to style submit buttons based on the validation of a form.
Specifications
Specification |
---|
HTML Standard # htmlbuttonelement |
Browser compatibility
BCD tables only load in the browser
See also
- HTML element implementing this interface:
<button>