The HTML <input type="button">
element is a specific version of the <input>
element used to create a clickable button with no default value. It has been superseded in HTML5 by the <button> element.
Browsers generate a control for a clickable button with no default value. The button can have any label on it. The control itself varies from one browser to another.
Content categories | Flow content, phrasing content, Interactive content, listed, labelable, and submittable form-associated element, palpable content. |
---|---|
Permitted content | Phrasing content. |
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parent elements | Any element that accepts phrasing content. |
DOM interface | HTMLButtonElement |
Element type | Inline |
Attributes
This element can have any of the global attributes in addition to the following:
disabled
-
This Boolean attribute indicates that the user cannot interact with the button. If this attribute is not specified, the button inherits its setting from the containing element, for example
<fieldset>
; if there is no containing element with thedisabled
attribute set, then the button is enabled. The disabled control's value isn't submitted with the form and theclick
event will not be dispatched on disabled controls. -
Firefox will, unlike other browsers, by default, persist the dynamic disabled state of a
<button>
across page loads. Use theautocomplete
attribute to control this feature. autofocus
HTML5- This Boolean attribute lets you specify that the button 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.
autocomplete
- The use of this attribute on a
<button>
is nonstandard and Firefox-specific. By default, unlike other browsers, Firefox persists the dynamic disabled state of a<button>
across page loads. Setting the value of this attribute tooff
(i.e.,autocomplete="off"
) disables this feature. form
HTML5- The form element that the button is associated with (its form owner). The value of the attribute must be the id attribute of a
<form>
element in the same document. If this attribute is not specified, the<button>
element must be a descendent of a form element. This attribute enables you to place<button>
elements anywhere within a document, not just as descendents of their<form>
elements. formenctype
- Since the input element is a submit button, the
formenctype
attribute specifies the type of content that is used to submit the form to the server. Possible values are:application/x-www-form-urlencoded
: The default value if the attribute is not specified.multipart/form-data
: This value is used if an<input>
element is used with thetype
attribute set tofile
.text/plain
If this attribute is specified, it overrides the
enctype
attribute of the element's form owner. formaction
HTML5- The URI of a program that processes the information submitted by the button. If specified, it overrides the
action
attribute of the button's form owner. formmethod
- Since the input element is a submit button, the
formmethod
attribute specifies the HTTP method that the browser uses to submit the form. Possible values are:post
: The data from the form is included in the body of the form and is sent to the server.get
: The data from the form is appended to the form attribute URI, with a '?' as a separator, and the resulting URI is sent to the server. Use this method when the form has no side-effects and contains only ASCII characters.
If specified, this attribute overrides the
method
attribute of the element's form owner. formnovalidate
- Since the input element is a submit button, the
formnovalidate
attribute specifies that the form is not to be validated when it is submitted. If this attribute is specified, it overrides thenovalidate
attribute of the element's form owner. This is a Boolean attribute. formtarget
- Since the input element is a submit button, the
formtarget
attribute is a name or keyword indicating where to display the response that is received after submitting the form. This is a name of, or keyword for, a browsing context (for example, tab, window, or inline frame). If this attribute is specified, it overrides thetarget
attribute of the element's form owner. The following keywords have special meanings:- _
self
: Load the response into the same browsing context as the current one. This value is the default if the attribute is not specified. _blank
: Load the response into a new unnamed browsing context._parent
: Load the response into the parent browsing context of the current one. If there is no parent, this option behaves the same way as_self
._top
: Load the response into the top-level browsing context (that is, the browsing context that is an ancestor of the current one, and has no parent). If there is no parent, this option behaves the same way as_self
.
- _
name
- The name of the button, which is submitted with the form data.
type
- The type of the button. Possible values are:
submit
: The button submits the form data to the server. This is the default if the attribute is not specified, or if the attribute is dynamically changed to an empty or invalid value.reset
: The button resets all the controls to their initial values.button
: The button has no default behavior. It can have client-side scripts associated with the element's events, which are triggered when the events occur.
value
- The initial value of the button.
Examples
This creates a new button input with the label 'Click me'.
<input type="button" value="Click me">
Specifications
Specification | Status |
WHATWG HTML Living Standard The definition of '<button>' in that specification. |
Living Standard |
HTML5 The definition of '<button>' in that specification. |
Recommendation |
HTML 4.01 Specification The definition of '<button>' in that specification. |
Recommendation |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
formenctype attribute |
9.0 | 4.0 (2.0) | 10 | 10.6 | ? |
formmethod attribute |
9.0 | 4.0 (2.0) | 10 | ? | ? |
autofocus attribute |
9.0 | 4.0 (2.0) | 10 | 9.6 | 5.0 |
formaction attribute |
9.0 | 4.0 (2.0) | 10 | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
formenctype attribute |
? | 4.0 (2.0) | ? | ? | ? |
formmethod attribute |
? | 4.0 (2.0) | ? | ? | ? |
formaction attribute |
? | 4.0 (2.0) | ? | ? | ? |
See also
- The generic
<input>
element and the interface used to manipulate it,HTMLInputElement
- The HTML5 replacement for <input type="button">, the <button> element.