HTMLFormControlsCollection: namedItem() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **HTMLFormControlsCollection.namedItem()** method returns the {{domxref("RadioNodeList")}} or the {{domxref("Element")}} in the collection whose name or id match the specified name, or null if no node matches.
Note that this version of namedItem() hides the one inherited from {{domxref("HTMLCollection")}}. Like that one, in JavaScript, using the array bracket syntax with a {{jsxref("String")}}, like collection["value"] is equivalent to collection.namedItem("value").
Syntax
namedItem(name)
[name]Parameters
name- : A string which will be used to match against the
nameoridattributes of the controls in thisHTMLFormControlsCollectionobject.
Return value
- A {{domxref("RadioNodeList")}} if there are multiple elements with the given
nameorid, - An {{domxref("Element")}} if there is exactly one element with the given
nameorid, or - [
null](/en-US/docs/Web/JavaScript/Reference/Operators/null) if no element has the givennameorid.
توجه: The returned {{domxref("RadioNodeList")}} is live, meaning that its contents automatically update if elements that match the given name are added to or removed from the collection. Furthermore, it may contain non-radio input elements despite the collection's name.
Examples
Using namedItem()
HTML
<form>
<label for="yes">Yes</label>
<input id="yes" name="my-radio" type="radio" />
<label for="no">No</label>
<input id="no" name="my-radio" type="radio" />
<label for="maybe">Maybe</label>
<input id="maybe" name="my-radio" type="radio" />
<br />
<label for="checkbox1">Checkbox</label>
<input id="checkbox1" name="my-form-control" type="checkbox" />
</form>
<div id="output"></div>JavaScript
const form = document.querySelector("form");
const items = form.elements.namedItem("my-radio");
const output = document.querySelector("#output");
const itemIDs = Array.from(items)
.map((item) => `"${item.id}"`)
.join(", ");
const item2 = form.elements.namedItem("my-form-control");
output.textContent = `My items: ${itemIDs}
My single item: "${item2.id}"`;Result
{{EmbedLiveSample("Using namedItem()")}}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("HTMLCollection.namedItem")}} that it replaces