Element.getElementsByTagNameNS()

La méthode Element.getElementsByTagNameNS() renvoie un objet HTMLCollection avec le nom de balise donné appartenant à l'espace de noms donné. Elle est semblable à la méthode Document.getElementsByTagNameNS mais cette dernière recherche sur l'ensemble du document tandis que getElementsByTagNameNS() recherche parmi les descendants de l'élément courant.

Syntaxe

elements = element.getElementsByTagNameNS(namespaceURI,localName);

Paramètres

namespaceURI

L'URI de l'espace de noms des éléments à rechercher (cf. namespaceURI). Par exemple, si vous recherchez des éléments XHTML, utilisez l'URI d'espace de noms XHTML, http://www.w3.org/1999/xhtml.

localName

Le nom local des éléments à rechercher ou la valeur spéciale "*" (correspondant à tous les éléments). Voir Node.localName.

Valeur de retour

Une collection HTMLCollection des éléments trouvés, dans l'ordre d'apparition dans l'arbre du DOM.

Exemples

// vérifie l'alignement d'une série de cellules d'un tableau dans un document XHTML.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "td");
for (var i = 0; i < cells.length; i++) {
  var axis = cells[i].getAttribute("axis");
  if (axis == "year") {
    // saisit les données
  }
}

Spécifications

Spécification État Commentaires
DOM
La définition de 'Element.getElementsByTagNameNS()' dans cette spécification.
Standard évolutif Modification du type de la valeur de retour : passage de NodeList à HTMLCollection.
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Element.getElementsByTagNameNS()' dans cette spécification.
Obsolete Aucune modification depuis Document Object Model (DOM) Level 2 Core Specification.
Document Object Model (DOM) Level 2 Core Specification
La définition de 'Element.getElementsByTagNameNS()' dans cette spécification.
Obsolete Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser