HTMLButtonElement

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 表明按钮的行为。这个属性是枚举类型，可以是以下的值：
  • "submit": 这个按钮会提交表单。如果不指定该属性，这是默认值。HTML5 中可以动态改为空值或者无效值。
  • "reset": 用于重置（清空）表单。
  • "button": 什么都不做的按钮。通常通过Javascript挂载事件。
  • "menu": 显示菜单的按钮 。
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>

文档标签和贡献者