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.

In diesem Artikel

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

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

HTMLCollection.namedItem, die es ersetzt

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

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

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

HTML DOM API
HTMLFormControlsCollection
Instanzmethoden
1. namedItem()
Vererbung
1. HTMLCollection
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung