HTMLFormControlsCollection: Methode namedItem()

Baseline

Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die Methode HTMLFormControlsCollection.namedItem() gibt die RadioNodeList oder das Element aus der Collection zurück, dessen name oder id mit dem angegebenen Namen übereinstimmt. Wenn kein Knoten übereinstimmt, gibt sie null zurück.

Beachten Sie, dass diese Version von namedItem() die von HTMLCollection geerbte Methode verdeckt. Wie bei der geerbten Methode ist in JavaScript die Verwendung der Array-Klammernotation mit einem String, etwa collection["value"], gleichbedeutend mit collection.namedItem("value").

Syntax

namedItem(name)
[name]

Parameter

name: Ein String, der mit den Attributen name oder id der Steuerelemente in diesem HTMLFormControlsCollection-Objekt abgeglichen wird.

Rückgabewert

Eine RadioNodeList, wenn mehrere Elemente den angegebenen name oder die angegebene id haben,
ein Element, wenn genau ein Element den angegebenen name oder die angegebene id hat, oder
null, wenn kein Element den angegebenen name oder die angegebene id hat.

Hinweis: Die zurückgegebene RadioNodeList ist live. Das bedeutet, dass sich ihr Inhalt automatisch aktualisiert, wenn Elemente, die dem angegebenen Namen entsprechen, zur Collection hinzugefügt oder daraus entfernt werden. Trotz ihres Namens kann sie auch Eingabeelemente enthalten, die keine Radio-Buttons sind.

Beispiele

namedItem() verwenden

HTML

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>

div {
  margin: 1rem 0;
}

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}"`;

Ergebnis

Spezifikationen

Spezifikation
HTML # dom-htmlformcontrolscollection-nameditem-dev

Browser-Kompatibilität

Siehe auch

HTMLCollection.namedItem, die durch diese Methode ersetzt wird

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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