HTMLButtonElement

基线 广泛可用

此功能已稳定,可在许多设备和浏览器版本上运行。它自以下时间起在各浏览器中可用: 2015 年 7 月.

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

EventTarget Node Element HTMLElement HTMLButtonElement

实例属性

继承其父级 HTMLElement 的属性。

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 事件,则还会将结果报告给用户。

规范

规范
HTML 标准
# htmlbuttonelement

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

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