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 Standard
# dom-htmlformcontrolscollection-nameditem-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch