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.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLFieldSetElement" target="_top"><rect x="301" y="65" width="190" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="396" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLFieldSetElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Properties
Inherits properties from its parent, HTMLElement.
HTMLFieldSetElement.disabled- A
Booleanreflecting thedisabledHTML attribute, indicating whether the user can interact with the control. HTMLFieldSetElement.elementsRead only- The elements belonging to this field set. The type of this property depends on the version of the spec that is implemented by the browser.
HTMLFieldSetElement.formRead only- An
HTMLFormControlsCollectionorHTMLCollectionreferencing 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 thenullvalue if none matches. HTMLFieldSetElement.name- A
DOMStringreflecting thenameHTML attribute, containing the name of the field set, used for submitting the form. HTMLFieldSetElement.typeRead only- The
DOMString"fieldset". HTMLFieldSetElement.validationMessage- A
DOMStringrepresenting 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 (willValidateisfalse), or it satisfies its constraints. HTMLFieldSetElement.validity- A
ValidityStaterepresenting the validity states that this element is in. HTMLFieldSetElement.willValidate- A
Booleanfalse, because<fieldset>objects are never candidates for constraint validation.
Methods
Inherits methods from its parent, HTMLElement.
HTMLFieldSetElement.checkValidity()- Always returns
truebecause<fieldset>objects are never candidates for constraint validation. HTMLFieldSetElement.setCustomValidity()- 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. |
| HTML 5.1 The definition of 'HTMLFieldSetElement' in that specification. |
Recommendation | |
| 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 |
| Document Object Model (DOM) Level 1 Specification The definition of 'HTMLFieldSetElement' in that specification. |
Recommendation | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | 1.0 (1.7 or earlier) | (Yes)[1] | (Yes) | (Yes) |
Change type of elements property to HTMLCollection |
57 | ? | ? | ? | 44 | ? |
| Feature | Android Webview | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
Change type of elements property to HTMLCollection |
57 | 57 | ? | ? | ? | 44 | ? |
[1] IE 11 does not seem to support the elements property on HTMLFieldSetElement
See also
- The HTML element implementing this interface:
<fieldset>.
Document Tags and Contributors
Tags:
Contributors to this page:
Sebastianz,
jakubfiala,
jpmedley,
danielnixon,
erikadoyle,
Manuel_Strehl,
teoli,
markg,
Nexii,
MHasan,
kscarfone,
Sheppy,
ethertank,
Ms2ger,
jswisher
Last updated by:
Sebastianz,