The HTMLFieldSetElement interface has special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of field-set elements.
Properties
Inherits properties from its parent, HTMLElement.
| Name | Type | Description |
|---|---|---|
disabled |
Boolean |
Reflects the disabled HTML attribute, indicating whether the user can interact with the control. |
elements Read only |
HTMLFormControlsCollection |
The elements belonging to this field set. |
form Read only |
HTMLFormElement |
The containing form element, if this element is in a form. If the button is not a descendant of a form element, then the attribute can be the ID of any form element in the same document it is related to, or the null value if none matches. |
name |
DOMString |
Reflects the name HTML attribute, containing the name of the field set, used for submitting the form. |
type Read only |
DOMString |
Must be the string fieldset. |
validationMessage Read only |
DOMString |
A localized message that describes the validation constraints that the element does not satisfy (if any). This is the empty string if the element is not a candidate for constraint validation (willValidate is false), or it satisfies its constraints. |
validity Read only |
ValidityState |
The validity states that this element is in. |
willValidate |
Boolean |
Always false because <fieldset> objects are never candidates for constraint validation. |
Methods
Inherits methods from its parent, HTMLElement.
| Name & Arguments | Return | Description |
|---|---|---|
checkValidity() |
Boolean |
Always returns true because <fieldset> objects are never candidates for constraint validation. |
setCustomValidity() |
void |
Sets a custom validity message for the field set. If this message is not the empty string, then the field set is suffering from a custom validity error, and does not validate. |
Specifications
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'HTMLFieldSetElement' in that specification. |
Living Standard | No change from HTML5. |
| HTML5.1 The definition of 'HTMLFieldSetElement' in that specification. |
Working Draft | |
| HTML5 The definition of 'HTMLFieldSetElement' in that specification. |
Recommendation | The following properties have been added: disabled, elements, name, type, valdiationMessage, validity, and willValidate.The following methods have been added: checkValidity(), setCustomValidity(). |
| Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLFieldSetElement' in that specification. |
Recommendation | No change from Document Object Model (DOM) Level 1 Specification. |
| Document Object Model (DOM) Level 1 Specification The definition of 'HTMLFieldSetElement' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | (Yes) | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
See also
- The HTML element implementing this interface:
<fieldset>.