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>
。