class js.html.ButtonElement extends Element

Available on js

DOM Button objects expose the HTMLButtonElement HTML5 (or HTMLButtonElement HTML 4) interface, which provides properties and methods (beyond the element object interface they also have available to them by inheritance) for manipulating the layout and presentation of button elements.

Documentation for this class was provided by MDN.

Instance Fields

var autofocus:Bool

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.

var disabled:Bool

The control is disabled, meaning that it does not accept any clicks.

var form:FormElement

The form that this button is associated with. If the button is a descendant of a form element, then this attribute is the ID of that form element.

If the button is not a descendant of a form element, then:

  • HTML5 The attribute can be the ID of any form element in the same document.
  • HTML 4 The attribute is null.

var formAction:String

The URI of a program that processes information submitted by the button. If specified, this attribute overrides the

action attribute of the <form> element that owns this element.

var formMethod:String

The HTTP method that the browser uses to submit the form. If specified, this attribute overrides the

method attribute of the <form> element that owns this element.

var formNoValidate:Bool

Indicates that the form is not to be validated when it is submitted. If specified, this attribute overrides the

enctype attribute of the <form> element that owns this element.

var formTarget:String

A name or keyword indicating where to display the response that is received after submitting the form. If specified, this attribute overrides the

target attribute of the <form> element that owns this element.

var labels:NodeList

A list of <label> elements that are labels for this button.

var name:String

The name of the object when submitted with a form. HTML5 If specified, it must not be the empty string.

var type:String

Indicates 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, HTML5 or if it is dynamically changed to an empty or invalid value.
  • reset: The button resets the form.
  • button: The button does nothing.

var validationMessage:String

A 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 is false), or it satisfies its constraints.

var validity:ValidityState

The validity states that this button is in.

var value:String

The current form control value of the button. 

var willValidate:Bool

Indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation.

function checkValidity():Bool

function setCustomValidity(error:String):Void