HTMLFieldSetElement - 操作 <fieldset> 元素
HTMLFieldSetElement 接口提供了特殊的属性和方法(除了通过继承通用的 HTMLElement 接口获得的常规属性)来操作 <fieldset> 元素的布局和显示。
属性
从其父类 HTMLElement 继承了属性。
HTMLFieldSetElement.disabled
一个 Boolean,反映了 disabled HTML 属性,指示用户是否可以与控件交互。
HTMLFieldSetElement.elements 只读
属于该字段集的元素。该属性的类型取决于浏览器实现的规范版本。
HTMLFieldSetElement.form 只读
如果该元素在表单中,则是引用包含表单元素的 HTMLFormControlsCollection 或 HTMLCollection}。
如果该 field set 不是表单元素的后代,则该属性可以是与其相关的同一文档中的任何表单元素的 ID,如果没有匹配,则为 null 值。
HTMLFieldSetElement.name
一个 DOMString,反映了 name HTML 属性,包含字段集的名称,用于提交表单。
HTMLFieldSetElement.type只读
一个 DOMString:"fieldset".
HTMLFieldSetElement.validationMessage
一个 DOMString,表示一个本地化消息,描述了该元素不满足的验证约束(如果有的话)。如果元素不是约束验证的候选者(willValidate 是 false),则它是空字符串,或者它满足其约束。
HTMLFieldSetElement.validity
一个 ValidityState,表示该元素所在的有效性状态。
HTMLFieldSetElement.willValidate
一个 Boolean:false,因为 <fieldset> 对象永远不是约束验证的候选对象。
方法
从其父类 HTMLElement 继承了方法。
HTMLFieldSetElement.checkValidity()
始终返回 true,因为 <fieldset> 对象永远不是约束验证的候选对象。
HTMLFieldSetElement.reportValidity()
始终返回 true,因为 <fieldset> 对象永远不是约束验证的候选对象。
HTMLFieldSetElement.setCustomValidity()
为该 field set 设置自定义有效性消息。如果该消息不是空字符串,则 field set 会受到自定义有效性错误的影响,并且不会进行验证。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| HTML Living Standard HTMLFieldSetElement 的定义 |
现行的标准 | - |
| HTML 5.1 HTMLFieldSetElement 的定义 |
推荐 | - |
| HTML5 HTMLFieldSetElement 的定义 |
推荐 | 添加了以下属性:disabled,elements,name,type,valdiationMessage,validity和willValidate。添加了以下方法: checkValidity(),setCustomValidity()。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLFieldSetElement 的定义 |
已过时 | 没有变化 |
| Document Object Model (DOM) Level 1 Specification HTMLFieldSetElement 的定义 |
已过时 | 初始定义 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
disabled |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
elements |
支持 | 支持 | 1 | 不支持 | 支持 | 支持 |
form |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
name |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
type |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
validationMessage |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
validity |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
willValidate |
支持 | 支持 | 1 | 支持 | 支持 | 支持 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
disabled |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
elements |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
form |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
name |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
type |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
validationMessage |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
validity |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
willValidate |
支持 | 支持 | 支持 | 4 | 未知 | 未知 | 支持 |
相关链接
- 实现该接口的 HTML 元素:
<fieldset>。