HTMLButtonElement

HTMLButtonElement 接口提供操作button元素 (除了 <button> 对象,这个接口对继承了该对象的元素也有效)的属性和方法。

属性

从父对象HTMLElement继承的属性。

名字 类型 描述
accessKey DOMString 一个键盘字符构成的字符串,表明用哪个键盘字符能够访问这个按钮。
autofocus Boolean (en-US) 这个控件是否可以在页面加载时自动得到焦点。但用户选择了其他焦点除外。只有和表单关联的按钮该特性才有效。
disabled Boolean (en-US) 这个控件是否被禁用。被禁用的控件不接受任何输入和点击。
form 只读 HTMLFormElement 这个按钮所关联的表单元素。如果这个按钮是一个表单元素的后代元素,那么这个属性的值就是那个表单元素。
如果这个按钮不是一个表单元素的后代元素,那么这个数学可以是任意同文档中的表单元素,或者是 null 表明它没有关联任何表单。
formAction DOMString 一个处理提交信息的URI资源地址。如果指定该属性,会覆盖拥有该元素的<form> 元素的action 属性。
formEncType DOMString 表单要提交给服务器处理的内容的类型。如果指定该属性,会覆盖拥有该元素的<form> 元素的enctype 属性。
formMethod DOMString 浏览器提交表单内容的HTTP方法。如果指定该属性,会覆盖拥有该元素的<form> 元素的.method属性。
formNoValidate Boolean (en-US) 表明这个表单提交时是否需要验证。如果指定该属性,会覆盖拥有该元素的<form> 元素的.novalidate属性。
formTarget DOMString 一个名字或关键字,用于表明显示服务器响应的页面。如果指定该属性,会覆盖拥有该元素的<form> 元素的.target属性。
labels 只读 NodeList 一个<label> 元素表,说明哪些标签是归属这个button的。
menu  Experimental HTMLMenuElement (en-US) 如果该按钮type="menu",被点击的时候应该显示的菜单。
name DOMString 提交到服务器时表单描述该对象的name。 HTML5 如果指定该属性,不能使用空字符串 。
tabIndex long 用于表示该元素在tab按钮跳动过程中的序号的一个数字。
type DOMString 表明按钮的行为。这个属性是枚举类型,可以是以下的值:
  • "submit": 这个按钮会提交表单。如果不指定该属性,这是默认值。HTML5 中可以动态改为空值或者无效值。
  • "reset": 用于重置(清空)表单。
  • "button": 什么都不做的按钮。通常通过Javascript挂载事件。
  • "menu": 显示菜单的按钮 Experimental
validationMessage 只读 DOMString 报告该控件不满足验证要求的,提示给用户的看的信息。如果这个控件没有验证约束(willValidate值为false),或者满足验证的要求,那么这个属性为空字符串。
validity 只读 ValidityState 这个控件当前的验证状态。
value DOMString 这个控件当前的表单值。
willValidate Boolean (en-US) 表明这个按钮是否需要在提交前进行验证。如果不需要,这个属性值为false

方法

从父对象HTMLElement继承的方法。

名字 返回类型 描述
checkValidity() Boolean (en-US) 对按钮元素不支持。
setCustomValidity(in DOMString error) void 对按钮元素不支持。

在基于Gecko的浏览器中,在表单验证时会使用:-moz-submit-invalid (en-US) 伪类修饰提交按钮。

规范

规范 状态 注释
HTML Living Standard
HTMLAnchorElement
Living Standard 新添加的属性: menu
type 属性可以使用的新的值"menu"
HTML5
HTMLAnchorElement
Recommendation 属性tabindexaccesskey被定义在HTMLElement中。
添加了下列属性:autofocus, formAction, formEncType, formMethod, formNoValidate, formTarget, labels, validity, validationMessagewillValidate
添加了下列方法: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 最初的定义。

浏览器兼容性

BCD tables only load in the browser

另见

  • 实现该接口的HTML元素:<button>