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.

HTMLFieldSetElement.disabled
A Boolean reflecting the disabled HTML 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 HTMLFormControlsCollection or HTMLCollection 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 the null value if none matches.
HTMLFieldSetElement.name
A DOMString reflecting the name HTML attribute, containing the name of the field set, used for submitting the form.
HTMLFieldSetElement.typeRead only
The DOMString "fieldset".
HTMLFieldSetElement.validationMessage
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 is false), 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
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.
Obsolete No change
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLFieldSetElement' in that specification.
Obsolete Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes1 Yes Yes Yes
disabled Yes Yes1 Yes Yes Yes
elements Yes Yes1 No Yes Yes
form Yes Yes1 Yes Yes Yes
name Yes Yes1 Yes Yes Yes
type Yes Yes1 Yes Yes Yes
validationMessage Yes Yes1 Yes Yes Yes
validity Yes Yes1 Yes Yes Yes
willValidate Yes Yes1 Yes Yes Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes4 ? Yes ?
disabled Yes Yes Yes4 ? Yes ?
elements Yes Yes Yes4 ? Yes ?
form Yes Yes Yes4 ? Yes ?
name Yes Yes Yes4 ? Yes ?
type Yes Yes Yes4 ? Yes ?
validationMessage Yes Yes Yes4 ? Yes ?
validity Yes Yes Yes4 ? Yes ?
willValidate Yes Yes Yes4 ? Yes ?

See also

  • The HTML element implementing this interface: <fieldset>.

Document Tags and Contributors

 Last updated by: fscholz,