HTMLFormControlsCollection: namedItem() Methode

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Die HTMLFormControlsCollection.namedItem() Methode gibt die RadioNodeList oder das Element in der Sammlung zurck, 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.

Rckgabewert

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 zurckgegebene RadioNodeList ist live, was bedeutet, dass sich ihr Inhalt automatisch aktualisiert, wenn Elemente, die mit dem angegebenen Namen bereinstimmen, zur Sammlung hinzugefgt oder daraus entfernt werden. Darber 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-Kompatibilitt

Siehe auch

HTMLCollection.namedItem, die es ersetzt

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden