HTMLFormControlsCollection: namedItem() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLFormControlsCollection.namedItem() Methode gibt das RadioNodeList oder das Element in der Sammlung zurück, dessen name oder id mit dem angegebenen Namen übereinstimmt, oder null, wenn kein Knoten übereinstimmt.

Beachten Sie, dass diese Version von namedItem() die von HTMLCollection geerbte Version verbirgt. Wie diese, ist es in JavaScript, das Array-Klammer-Syntax mit einem String zu verwenden, wie collection["value"], gleichbedeutend mit collection.namedItem("value").

Syntax

js
namedItem(name)
[name]

Parameter

name

Ein String, der verwendet wird, um mit den name oder id Attributen der Steuerelemente in diesem HTMLFormControlsCollection Objekt zu vergleichen.

Rückgabewert

Beispiele

Verwendung von namedItem()

HTML

html
<form>
  <label for="notes">Notes:</label>
  <input id="notes" name="my-form-control" type="text" />

  <label for="start">Start date:</label>
  <input id="start" name="my-form-control" type="date" />
</form>

<div id="output"></div>

JavaScript

js
const form = document.querySelector("form");
const items = form.elements.namedItem("my-form-control");

const output = document.querySelector("#output");
const itemIDs = Array.from(items)
  .map((item) => `"${item.id}"`)
  .join(", ");
output.textContent = `My items: ${itemIDs}`;

Ergebnis

Spezifikationen

Specification
HTML
# dom-htmlformcontrolscollection-nameditem-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
namedItem

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Siehe auch