HTMLButtonElement 接口提供操作button元素 （除了 <button> 对象，这个接口对继承了该对象的元素也有效）的属性和方法。
属性
从父对象HTMLElement继承的属性。
| 名字 | 类型 | 描述 |
|---|---|---|
accessKey |
DOMString |
一个键盘字符构成的字符串，表明用哪个键盘字符能够访问这个按钮。 |
autofocus |
Boolean |
这个控件是否可以在页面加载时自动得到焦点。但用户选择了其他焦点除外。只有和表单关联的按钮该特性才有效。 |
disabled |
Boolean |
这个控件是否被禁用。被禁用的控件不接受任何输入和点击。 |
form 只读 |
HTMLFormElement |
这个按钮所关联的表单元素。如果这个按钮是一个表单元素的后代元素，那么这个属性的值就是那个表单元素。 如果这个按钮不是一个表单元素的后代元素，那么这个数学可以是任意同文档中的表单元素，或者是 null 表明它没有关联任何表单。 |
formAction |
DOMString |
一个处理提交信息的URI资源地址。如果指定该属性，会覆盖拥有该元素的<form> 元素的action 属性。 |
formEncType |
DOMString |
表单要提交给服务器处理的内容的类型。如果指定该属性，会覆盖拥有该元素的<form> 元素的enctype 属性。 |
formMethod |
DOMString |
浏览器提交表单内容的HTTP方法。如果指定该属性，会覆盖拥有该元素的<form> 元素的.method属性。 |
formNoValidate |
Boolean |
表明这个表单提交时是否需要验证。如果指定该属性，会覆盖拥有该元素的<form> 元素的.novalidate属性。 |
formTarget |
DOMString |
一个名字或关键字，用于表明显示服务器响应的页面。如果指定该属性，会覆盖拥有该元素的<form> 元素的.target属性。 |
labels 只读 |
NodeList |
一个<label> 元素表，说明哪些标签是归属这个button的。 |
menu |
HTMLMenuElement |
如果该按钮type="menu"，被点击的时候应该显示的菜单。 |
name |
DOMString |
提交到服务器时表单描述该对象的name。 HTML5 如果指定该属性，不能使用空字符串 。 |
tabIndex |
long | 用于表示该元素在tab按钮跳动过程中的序号的一个数字。 |
type |
DOMString |
表明按钮的行为。这个属性是枚举类型，可以是以下的值：
|
validationMessage 只读 |
DOMString |
报告该控件不满足验证要求的，提示给用户的看的信息。如果这个控件没有验证约束(willValidate值为false)，或者满足验证的要求，那么这个属性为空字符串。 |
validity 只读 |
ValidityState |
这个控件当前的验证状态。 |
value |
DOMString |
这个控件当前的表单值。 |
willValidate |
Boolean |
表明这个按钮是否需要在提交前进行验证。如果不需要，这个属性值为false 。 |
方法
从父对象HTMLElement继承的方法。
| 名字 | 返回类型 | 描述 |
|---|---|---|
checkValidity() |
Boolean |
对按钮元素不支持。 |
setCustomValidity(in DOMString error) |
void |
对按钮元素不支持。 |
在基于Gecko的浏览器中，在表单验证时会使用:-moz-submit-invalid 伪类修饰提交按钮。
规范
| 规范 | 状态 | 注释 |
|---|---|---|
| WHATWG HTML Living Standard HTMLAnchorElement |
Living Standard | 新添加的属性： menu。type 属性可以使用的新的值"menu"。 |
| HTML5 HTMLAnchorElement |
Recommendation | 属性tabindex 和accesskey被定义在HTMLElement中。添加了下列属性： autofocus, formAction, formEncType, formMethod, formNoValidate, formTarget, labels, validity, validationMessage和 willValidate。添加了下列方法： checkValidity(), setCustomValidity().type 属性不再是只读的。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLAnchorElement |
Recommendation | 和 Document Object Model (DOM) Level 1 Specification一样 |
| Document Object Model (DOM) Level 1 Specification HTMLAnchorElement |
Recommendation | 最初的定义。 |
浏览器兼容性
| 特性 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| 基本支持 | (Yes) | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
| 与表单相关的属性 | (Yes) | 4.0 (2.0) | (Yes) | (Yes) | (Yes) |
labels |
(Yes) | 未实现 未实现 (查看 bug 556743) | ? | ? | ? |
menu & type="menu" |
未实现 | 未实现 | 未实现 | 未实现 | 未实现 |
| 特性 | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本支持 | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
| 与表单相关的属性 | (Yes) | 4.0 (2.0) | (Yes) | (Yes) | (Yes) |
labels |
(Yes) | 未实现未实现 (查看 bug 556743) | ? | ? | ? |
menu & type="menu" |
未实现 | 未实现 | 未实现 | 未实现 | 未实现 |
另见
- 实现该接口的HTML元素：
<button>