HTMLButtonElement

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

HTMLButtonElement 接口提供了用于操作 <button> 元素的属性和方法(除了它通过继承从 HTMLElement 接口继承的常规属性和方法)。

EventTarget Node Element HTMLElement HTMLButtonElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLButtonElement.command

一个字符串值,指示要在此按钮所控制的元素上执行的操作。

HTMLButtonElement.commandForElement

指向一个现有 Element 的引用,该元素由此按钮控制。

HTMLButtonElement.disabled

一个布尔值,指示控件是否被禁用,这意味着它不接受任何点击。

HTMLButtonElement.form 只读

一个 HTMLFormElement,反映了此按钮所属的表单。如果按钮是表单元素的后代,则此属性是对该表单的关联 HTMLFormElement 的引用。如果按钮不是表单元素的后代,则此属性可以是同一文档中与其相关的任何 HTMLFormElement 元素的引用,如果没有匹配项,则为 null 值。

HTMLButtonElement.formAction

一个字符串,反映了处理由按钮提交的信息的资源的 URI。如果指定了此属性,它将覆盖拥有此元素的 <form> 元素的 action 属性。

HTMLButtonElement.formEnctype

一个字符串,反映了用于将表单提交到服务器的内容类型。如果指定了此属性,它将覆盖拥有此元素的 <form> 元素的 enctype 属性。

HTMLButtonElement.formMethod

一个字符串,反映了浏览器用于提交表单的 HTTP 方法。如果指定了此属性,它将覆盖拥有此元素的 <form> 元素的 method 属性。

HTMLButtonElement.formNoValidate

一个布尔值,指示在提交表单时不对其进行验证。如果指定了此属性,它将覆盖拥有此元素的 <form> 元素的 novalidate 属性。

HTMLButtonElement.formTarget

一个字符串,反映了在提交表单后显示响应的名称或关键字。如果指定了此属性,它将覆盖拥有此元素的 <form> 元素的 target 属性。

HTMLButtonElement.labels 只读

一个 NodeList,表示一组 <label> 元素,它们是此按钮的标签。

HTMLButtonElement.name

提交表单时对象的名称。如果指定,则不能为空字符串。

HTMLButtonElement.popoverTargetAction

获取和设置由控制按钮执行的操作("hide""show""toggle")以控制弹出框元素。它反映了 popovertargetaction HTML 属性的值。

HTMLButtonElement.popoverTargetElement

获取和设置要通过按钮控制的弹出框元素。是 popovertarget HTML 属性的 JavaScript 等价物。

HTMLButtonElement.type

一个字符串,指示按钮的行为。这是一个枚举属性,具有以下可能值:

  • submit:按钮提交表单。如果未指定该属性,或者将其动态更改为空字符串或无效值,则此为默认值。
  • reset:按钮重置表单。
  • button:按钮不执行任何操作。
  • menu:按钮显示菜单。 实验性
HTMLButtonElement.willValidate 只读

一个布尔值,指示按钮是否是约束验证的候选对象。如果任何条件阻止其进行约束验证,则为 false,包括:其 type 属性为 resetbutton;它有 <datalist> 祖先;或者 disabled 属性设置为 true

HTMLButtonElement.validationMessage 只读

一个字符串,表示本地化的消息,描述控件不满足的验证约束(如果有)。如果控件不是约束验证的候选对象(willValidatefalse),或者它满足其约束,则此属性为空字符串。

HTMLButtonElement.validity 只读

一个 ValidityState,表示此按钮所处的有效性状态。

HTMLButtonElement.value

一个字符串,表示按钮的当前表单控件值。

实例方法

继承自其父级 HTMLElement 的方法.

HTMLButtonElement.checkValidity()

如果元素的价值没有有效性问题,则返回 true;否则返回 false

HTMLButtonElement.reportValidity()

执行与 checkValidity() 相同的操作,但如果 invalid 事件未被取消,还会将结果报告给用户。

HTMLButtonElement.setCustomValidity()

设置元素的自定义有效性消息。使用空字符串表示该元素*不*具有自定义有效性错误。

规范

规范
HTML
# htmlbuttonelement

浏览器兼容性

另见

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