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
Boolean
reflecting thedisabled
HTML attribute, indicating whether the user can interact with the control. HTMLFieldSetElement.elements
Read 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.form
Read only- An
HTMLFormControlsCollection
orHTMLCollection
referencing 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 thenull
value if none matches. HTMLFieldSetElement.name
- A
DOMString
reflecting thename
HTML attribute, containing the name of the field set, used for submitting the form. HTMLFieldSetElement.type
Read only- The
DOMString
"fieldset"
. HTMLFieldSetElement.validationMessage
- A
DOMString
representing 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
isfalse
), or it satisfies its constraints. HTMLFieldSetElement.validity
- A
ValidityState
representing the validity states that this element is in. HTMLFieldSetElement.willValidate
- A
Boolean
false
, because<fieldset>
objects are never candidates for constraint validation.
Methods
Inherits methods from its parent, HTMLElement
.
HTMLFieldSetElement.checkValidity()
- Always returns
true
because<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,