HTMLButtonElement - Web API 接口参考 编辑

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 伪类修饰提交按钮。

规范

规范	状态	注释
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	Obsolete	和 Document Object Model (DOM) Level 1 Specification一样
Document Object Model (DOM) Level 1 Specification HTMLAnchorElement	Obsolete	最初的定义。

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

特性	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>