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 ⁨Juli 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

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

Ein RadioNodeList, Element oder null.

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>

div {
  margin: 1rem 0;
}

JavaScript

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

Siehe auch

HTMLCollection.namedItem, das es ersetzt

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden