diff --git a/files/en-us/web/api/htmlfieldsetelement/elements/index.md b/files/en-us/web/api/htmlfieldsetelement/elements/index.md new file mode 100644 index 000000000000000..044aec572a53acd --- /dev/null +++ b/files/en-us/web/api/htmlfieldsetelement/elements/index.md @@ -0,0 +1,60 @@ +--- +title: "HTMLFieldSetElement: elements property" +short-title: elements +slug: Web/API/HTMLFieldSetElement/elements +page-type: web-api-instance-property +browser-compat: api.HTMLFieldSetElement.elements +--- + +{{APIRef("HTML DOM")}} + +The **`elements`** read-only property of the {{domxref("HTMLFieldSetElement")}} interface returns an {{domxref("HTMLCollection")}} object containing all form control elements ({{htmlelement("button")}}, {{htmlelement("fieldset")}}, {{htmlelement("input")}}, {{htmlelement("object")}}, {{htmlelement("output")}}, {{htmlelement("select")}}, and {{htmlelement("textarea")}}) that are descendants of this field set. + +You can access a particular form control in the returned collection by using either an +index or the element's `name` or `id` attributes. If multiple form controls share the same name, as is common with a group of radio buttons, using the shared name returns the first element with that value. + +## Value + +An {{domxref("HTMLCollection")}}. + +## Examples + +```html +
+
+ My fieldset +

+ + +

+

+ + +

+

+ + +

+
+
+``` + +```js +const fieldset = document.getElementById("my-fieldset"); +console.log(fieldset.elements.length); // 3 +console.log(fieldset.elements["remember-me"].value); // "on" +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLFieldSetElement")}} +- {{domxref("HTMLFormElement.elements")}} +- {{HTMLElement("fieldset")}}