HTMLFormControlsCollection: namedItem() Methode

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.

Die HTMLFormControlsCollection.namedItem() Methode gibt die 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 Methode verbirgt. Wie diese kann in JavaScript die Array-Klammer-Syntax mit einem String, wie collection["value"] verwendet werden, was gleichbedeutend mit collection.namedItem("value") ist.

Syntax

namedItem(name)
[name]

Parameter

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

Rückgabewert

Eine RadioNodeList, wenn es mehrere Elemente mit dem gegebenen name oder id gibt,
Ein Element, wenn es genau ein Element mit dem gegebenen name oder id gibt, oder
null, wenn kein Element den gegebenen name oder id hat.

Hinweis: Die zurückgegebene RadioNodeList ist live, was bedeutet, dass sich ihr Inhalt automatisch aktualisiert, wenn Elemente, die mit dem angegebenen Namen übereinstimmen, zur Sammlung hinzugefügt oder daraus entfernt werden. Darüber hinaus kann sie nicht-radioeingabe Elemente enthalten, trotz des Namens der Sammlung.

Beispiele

Verwendung von namedItem()

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="text1">Text input 1</label>
  <input id="text1" name="my-form-control" type="text" />
</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 es ersetzt

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