HTML DOM
HTMLButtonElement 接口提供操作 button 元素(除了 button 对象,这个接口对继承了该对象的元素也有效)的属性和方法。
属性
从父对象HTMLElement继承的属性。
<table> <thead> <tr> <th scope="col">名字</th> <th scope="col">类型</th> <th scope="col">描述</th> </tr> </thead> <tbody> <tr> <td><code>accessKey</code></td> <td>String</td> <td>一个键盘字符构成的字符串,表明用哪个键盘字符能够访问这个按钮。</td> </tr> <tr> <td><code>autofocus</code></td> <td>Boolean</td> <td> 这个控件是否可以在页面加载时自动得到焦点。但用户选择了其他焦点除外。只有和表单关联的按钮该特性才有效。 </td> </tr> <tr> <td><code>disabled</code></td> <td>Boolean</td> <td>这个控件是否被禁用。被禁用的控件不接受任何输入和点击。</td> </tr> <tr> <td><code>form</code> </td> <td>HTMLFormElement</td> <td> 这个按钮所关联的表单元素。如果这个按钮是一个表单元素的后代元素,那么这个属性的值就是那个表单元素。<br />如果这个按钮不是一个表单元素的后代元素,那么这个数学可以是任意同文档中的表单元素,或者是 <code>null</code> 表明它没有关联任何表单。 </td> </tr> <tr> <td><code>formAction</code></td> <td>String</td> <td> 一个处理提交信息的 URI 资源地址。如果指定该属性,会覆盖拥有该元素的 form 元素的 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/form#action"><code>action</code></a> 属性。 </td> </tr> <tr> <td><code>formEncType</code></td> <td>String</td> <td> 表单要提交给服务器处理的内容的类型。如果指定该属性,会覆盖拥有该元素的 form 元素的 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/form#enctype" ><code>enctype</code></a> 属性。 </td> </tr> <tr> <td><code>formMethod</code></td> <td>String</td> <td> 浏览器提交表单内容的 HTTP 方法。如果指定该属性,会覆盖拥有该元素的 form 元素的 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/form#method" ><code>method</code></a > 属性。 </td> </tr> <tr> <td><code>formNoValidate</code></td> <td>Boolean</td> <td> 表明这个表单提交时是否需要验证。如果指定该属性,会覆盖拥有该元素的 form 元素的 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/form#novalidate" ><code>novalidate</code></a > 属性。 </td> </tr> <tr> <td><code>formTarget</code></td> <td>String</td> <td> 一个名字或关键字,用于表明显示服务器响应的页面。如果指定该属性,会覆盖拥有该元素的 form 元素的 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/form#target" ><code>target</code></a > 属性。 </td> </tr> <tr> <td><code>labels</code> </td> <td>NodeList</td> <td> 一个 label 元素表,说明哪些标签是归属这个按钮的。 </td> </tr> <tr> <td><code>menu</code> </td> <td>HTMLMenuElement</td> <td>如果该按钮 <code>type="menu"</code>,被点击的时候应该显示的菜单。</td> </tr> <tr> <td><code>name</code></td> <td>String</td> <td> 提交到服务器时表单描述该对象的 name。如果指定该属性,不能使用空字符串。 </td> </tr> <tr> <td><code>tabIndex</code></td> <td>long</td> <td>用于表示该元素在 tab 按钮跳动过程中的序号的一个数字。</td> </tr> <tr> <td><code>type</code></td> <td>String</td> <td> 表明按钮的行为。这个属性是枚举类型,可以是以下的值: <ul> <li> <code>"submit"</code>:这个按钮会提交表单。如果不指定该属性,这是默认值。可以动态改为空值或者无效值。 </li> <li><code>"reset"</code>:用于重置(清空)表单。</li> <li> <code>"button"</code>:什么都不做的按钮。通常通过 Javascript 挂载事件。 </li> <li> <code>"menu"</code>:显示菜单的按钮 。 </li> </ul> </td> </tr> <tr> <td><code>validationMessage</code> </td> <td>String</td> <td> 报告该控件不满足验证要求的,提示给用户的看的信息。如果这个控件没有验证约束(<code>willValidate</code> 值为 <code>false</code>),或者满足验证的要求,那么这个属性为空字符串。 </td> </tr> <tr> <td><code>validity</code> </td> <td>ValidityState</td> <td>这个控件当前的验证状态。</td> </tr> <tr> <td><code>value</code></td> <td>String</td> <td>这个控件当前的表单值。</td> </tr> <tr> <td><code>willValidate</code></td> <td>Boolean</td> <td> 表明这个按钮是否需要在提交前进行验证。如果不需要,这个属性值为<code >false</code > 。 </td> </tr> </tbody> </table>
方法
从父对象HTMLElement继承的方法。
| 名字 | 返回类型 | 描述 |
|---|---|---|
checkValidity() |
Boolean | 对按钮元素不支持。 |
setCustomValidity(in DOMString error) |
void |
对按钮元素不支持。 |
在基于 Gecko 的浏览器中,在表单验证时会使用 :-moz-submit-invalid 伪类修饰提交按钮。
规范
浏览器兼容性
参见
- 实现该接口的 HTML 元素:button
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
