GetElementsByTagName (W3C DOM -Kernmethode)

Gibt

zurück Nodelist

Beispiel

var paragraphs = document.getElementByTagName('p');

Das obige Beispiel erhält einen Hinweis auf die Sammlung von P -Elementen innerhalb des aktuellen Dokuments und speichert es in den Variablen Absätzen . Die zurückgegebene Sammlung ist Live , was bedeutet, dass sich Änderungen an der von ihnen dargestellten HTML sofort in der Sammlung widerspiegeln, ohne sie erneut abrufen zu müssen.

Diese Methode kann auch kontextuell verwendet werden, um einen Verweis auf die Elemente zu erhalten, die sich in einem bestimmten Element befinden, zum Beispiel:

var items = list.getElementByTagName('li');

Wenn die -Liste in diesem Beispiel ein UL -Element wäre, beziehen sich die -Pelemente Variable auf eine Sammlung aller Li -Elemente, die sich in dieser Liste befinden.

Die Elemente werden in der linearen Reihenfolge abgerufen, in der sie im Dokument erscheinen, dh. Sie entsprechen einer abgeflachten Sicht des DOM. Wenn also im vorherigen Beispiel die Liste dieser HTML entsprach:

<ul>
  <li>Cheeses
    <ul>
      <li>Edam</li>
      <li>Gouda</li>
      <li>Cheddar</li>
    </ul>
  </li>
  <li>Hams
    <ul>
      <li>Prosciutto</li>
      <li>Parma</li>
      <li>Salami</li>
    </ul>
  </li>
</ul>

Die zurückgegebene Sammlung wäre in der folgenden Reihenfolge:

1. [0] Käse
2. [1] edam
3. [2] Gouda
4. [3] Cheddar
5. [4] Schinken
6. [5] Prosciutto
7. [6] Parma
8. [7] Salami

Argumente

Name (Domstring) erforderlich Der Tagname der zu entsprechenden Elemente. Der Wert * entspricht allen Elementen.

Beschreibung

Erhalten Sie eine geordnete Liste aller Elemente mit einem bestimmten Tag -Namen, bei dem es sich um Nachkommen dieses Dokuments oder Elements handelt, in der linearen Reihenfolge, in der sie im DOM -Baum erscheinen. Die zurückgegebene Sammlung ist ein Nodelist - eine geordnete Sammlung von Knoten, die numerisch in Null beginnt. Wenn es keine passenden Elemente gibt, handelt es sich um eine Sammlung mit null Mitgliedern.

Eine Sammlung ist kein Array

Auch wenn eine Sammlung wie ein Array aussieht, ist sie kein Array - obwohl Sie sie durch sie itererieren und auf seine Mitglieder wie ein Array verweisen können, können Sie keine Array -Methoden wie Push oder Pop verwenden.

Rückgabewert

Ein Nodelist, der alle übereinstimmenden Elemente enthält; Wenn keine Elemente festgestellt werden, ist dies eine Liste mit null Mitgliedern.

häufig gestellte Fragen (FAQs) zu GetElementsByTagName -Methoden

Was ist die GetElementsByTagName -Methode in JavaScript? Diese Methode gibt eine Live -HTMLCollection von Elementen mit dem angegebenen Tag -Namen zurück. Die zurückgegebene Sammlung ist live, dh sie aktualisiert sich automatisch, um mit dem DOM -Baum synchron zu bleiben. Daher werden Änderungen in der DOM in der Sammlung widerspiegelt.

Wie unterscheidet sich die GetElementsByTagName -Methode von anderen DOM -Auswahlmethoden? Für Div -Tags. Dies macht es zu einer vielseitigen Methode für die Auswahl mehrerer Elemente desselben Typs und nicht für diejenigen mit einer bestimmten ID oder Klasse. du kannst. Während es üblich ist, GetElementsByTagName im Dokumentobjekt zu verwenden, können Sie es auch auf jedem Elementknoten verwenden. Auf diese Weise können Sie Ihre Auswahl auf einen bestimmten Abschnitt des Dokuments eingrenzen. ist ein Array-ähnliches Objekt. Sie können mithilfe von Bracket Notation auf einzelne Elemente in dieser Sammlung zugreifen, genau wie Sie es mit einem Array tun würden. Wenn Sie beispielsweise auf das erste Element zugreifen möchten, können Sie die Sammlung [0] verwenden. ist Array-ähnlich, es ist kein echtes Array. Dies bedeutet, dass Sie Array -Methoden wie Push, Pop oder Slice nicht direkt verwenden können. Sie können es jedoch mit Array.from () oder dem Spread Operator (…) in ein echtes Array konvertieren. Live -Sammlung bedeutet, dass es automatisch aktualisiert wird, um Änderungen im DOM widerzuspiegeln. Wenn Elemente aus dem Dokument hinzugefügt oder entfernt werden, wird die Sammlung aktualisiert, um diese Elemente einzuschließen oder auszuschließen. Die GetElementsByTagName -Methode ist Teil des W3C -DOM -Kerns, was bedeutet, dass sie für jedes Dokument anwendbar ist, das die DOM einschließlich XML -Dokumente verwendet. Dokumente, die GetElementsByTagName-Methode ist von Fall unempfindlich, dh es spielt keine Rolle, ob Sie Groß- oder Kleinbuchstaben verwenden. In XML-Dokumenten ist es jedoch Fallempfindlichkeit. Sie können sowohl einen Namespace als auch einen lokalen Namen angeben. GetElementsByTagName? Denken Sie daran, dass die Sammlung live ist. Wenn Sie also Elemente in der Schleife hinzufügen oder entfernen, müssen Sie dies möglicherweise berücksichtigen, um unerwartete Ergebnisse zu vermeiden.

Das obige ist der detaillierte Inhalt vonGetElementsByTagName (W3C DOM -Kernmethode). Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!