GetElementsByTagName (méthode W3C DOM Core)

retourne

NodeList

Exemple

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

L'exemple ci-dessus obtient une référence à la collection d'éléments P dans le document actuel et l'enregistre aux paragraphes variables . La collection retournée est live , ce qui signifie que les modifications du HTML qu'il représente sont immédiatement reflétées dans la collection, sans avoir à la récupérer à nouveau.

Cette méthode peut également être utilisée contextuellement, pour obtenir une référence aux éléments qui se trouvent à l'intérieur d'un élément spécifique, par exemple:

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

Donc, si la liste Liste dans cet exemple était un élément UL, la variable items ferait référence à une collection de tous les éléments Li qui se trouvent à l'intérieur de cette liste.

Les éléments sont récupérés dans l'ordre linéaire dans lequel ils apparaissent dans le document, c'est-à-dire. Ils correspondent à une vue aplatie du DOM. Donc, si, dans l'exemple précédent, la liste correspondait à ce html:

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

La collection retournée serait dans l'ordre suivant:

1. [0] fromages
2. [1] Edam
3. [2] Gouda
4. [3] Cheddar
5. [4] HAMS
6. [5] prosciutto
7. [6] Parme
8. [7] Salami

Arguments

Nom (Domstring) requis Le nom des éléments à correspondre. La valeur * correspond à tous les éléments.

Description

Obtenez une liste ordonnée de tous les éléments avec un nom de balise donné, qui sont des descendants de cet ou élément, dans l'ordre linéaire dans lequel ils apparaissent dans l'arbre Dom. La collection retournée est un Nodelist - une collection ordonnée de nœuds, indexée numériquement à partir de zéro. S'il n'y a pas d'éléments correspondants, c'est une collection avec Zero Membres.

Une collection n'est pas un tableau

Même si une collection ressemble à un tableau, ce n'est pas un tableau - bien que vous puissiez le parcourir et vous référer à ses membres comme un tableau, vous ne pouvez pas utiliser des méthodes de tableau comme Push ou Pop dessus.

Valeur de retour

Un nodeliste contenant tous les éléments correspondants; Si aucun éléments n'est trouvé, ce sera une liste avec zéro membres.

Questions fréquemment posées (FAQ) sur GetElementsByTagName Méthode

Quelle est la méthode GetElementsByTagName dans JavaScript?

La méthode GetElementsByTagName est un outil puissant de JavaScript qui vous permet d'accéder et de manipuler des éléments HTML basés sur leur nom de balise. Cette méthode renvoie une HTMLCollection en direct des éléments avec le nom de balise donné. La collection retournée est en direct, ce qui signifie qu'il se met automatiquement à jour pour rester en synchronisation avec l'arborescence DOM. Par conséquent, les changements dans le DOM seront reflétés dans la collection.

En quoi la méthode GetElementsByTagName diffère-t-elle des autres méthodes de sélection de DOM?

Contrairement aux méthodes telles que GetElementById ou GetElementsByClassName, GetElementsByTagName sélectionne des éléments en fonction de leur nom de balise, tels que 'P' pour les balises de paragraphe ou 'Div' pour les balises Div. Cela en fait une méthode polyvalente pour sélectionner plusieurs éléments du même type, plutôt que ceux avec un ID ou une classe spécifique.

Puis-je utiliser GetElementsByTagname sur des éléments autres que le document?

Oui, oui, tu peux. Bien qu'il soit courant d'utiliser GetElementsByTagName sur l'objet Document, vous pouvez également l'utiliser sur n'importe quel nœud d'élément. Cela vous permet de réduire votre sélection à une section spécifique du document.

Comment puis-je accéder aux éléments individuels à partir de la collection renvoyée par GetElementsByTagname?

La méthode GetElementsByTagName renvoie une HTMLCollection en direct, qui, quelle est un objet de type tableau. Vous pouvez accéder aux éléments individuels de cette collection en utilisant la notation du support, tout comme vous le feriez avec un tableau. Par exemple, si vous souhaitez accéder au premier élément, vous pouvez utiliser la collection [0].

Puis-je utiliser des méthodes de tableau sur la collection renvoyées par GetElementsByTagname?

Pendant que la collection renvoyée par GetElementsByTagName est en forme de tableau, ce n'est pas un vrai tableau. Cela signifie que vous ne pouvez pas utiliser directement des méthodes de tableau comme Push, Pop ou Slice dessus. Cependant, vous pouvez le convertir en un vrai tableau à l'aide de Array.From () ou de l'opérateur de diffusion (…).

Qu'est-ce que cela signifie que la collection renvoyée par GetElementsByTagname est en direct?

A A La collection en direct signifie qu'il met automatiquement à jour pour refléter les changements dans le DOM. Si des éléments sont ajoutés ou supprimés du document, la collection mettra à jour pour inclure ou exclure ces éléments.

Puis-je utiliser GetElementsByTagname avec des documents XML?

Oui, vous pouvez. La méthode GetElementsByTagname fait partie du noyau DOM W3C, ce qui signifie qu'il est applicable à tout document qui utilise le DOM, y compris les documents XML.

Comment la sensibilité des cas affecte-t-elle la méthode GetElementsByTagname?

dans HTML Documents, la méthode GetElementsByTagName est insensible à la casse, ce qui signifie que vous n'êtes pas important de savoir si vous utilisez des lettres majuscules ou minuscules. Cependant, dans les documents XML, il est sensible à la casse.

Puis-je utiliser GetElementsByTagName pour sélectionner des éléments dans un espace de noms spécifique?

Pour cela, vous devrez utiliser la méthode GetElementsByTagnamens, qui permet vous pour spécifier à la fois un espace de noms et un nom local.

Comment puis-je traverser les éléments renvoyés par getElementsByTagName?

Vous pouvez traverser les éléments à l'aide d'une boucle pour une boucle ou un pour… de boucle. N'oubliez pas que la collection est en direct, donc si vous ajoutez ou supprimez des éléments dans la boucle, vous devrez peut-être prendre cela en compte pour éviter les résultats inattendus.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!