La méthode Element.getElementsByTagNameNS() renvoie une liste d'éléments avec le nom de balise donné appartenant à l'espace de noms donné. Il est similaire à  Document.getElementsByTagNameNS, à part que sa recherche est restreinte aux descendants de l'élément spécifié.

Syntaxe

elements =element.getElementsByTagNameNS(namespaceURI,localName) 
  • elements est une  HTMLCollection des éléments trouvés dans leur ordre d'apparition dans l'arbre.
  • element est l'élément depuis lequel la recherche doit débuter. Notez que seuls les descendants de cet élément font partie de la recherche, pas le nœud lui-même.
  • namespaceURI est l'URI d'espace de noms des éléments à rechercher (voir namespaceURI()). Par exemple, si vous cherchez des éléments XHTML, utilisez l'URI d'espace de noms XHTML, http://www.w3.org/1999/xhtml.
  • localName est soit le nom local des éléments à rechercher, soit la valeur spéciale "*", qui correspond à tous les éléments (voir Node.localName ).

Exemple

// 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 Statut Commentaire
DOM
La définition de 'Element.getElementsByTagNameNS()' dans cette spécification.
Standard évolutif Change la valeur de retour de NodeList à HTMLCollection.
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Element.getElementsByTagNameNS()' dans cette spécification.
Obsolete Pas de changement par rapport à 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.

Browser compatibility

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0[1] (Oui) (Oui)[2] 5.5 (Oui)[1] (Oui)[1]
getElementsByTagName("*") 1.0 (Oui) (Oui) 6.0 (Oui) (Oui)
Fonctionnalité Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Oui) (Oui) (Oui)[2] (Oui) (Oui) (Oui)

[1] Initiallement, cette méthode retournait une NodeList ; elle a été modifiée pour refléter  le changement de spécification.

[2] Le comportement de element.getElementsByTagNameNS a été changé entre  Firefox 3.5 et Firefox 3.6. Dans Firefox 3.5 et avant, cette fonction devait  déplier automatiquement toutes les requêtes de sorte que la recherche de "foo" corresponde à "Foo" ou "foo" . In Firefox 3.6 et suivants, la fonction est maintenant sensible à la casse, donc une requête pour "foo" ne correspondra qu'à "foo" et non "Foo". Pour plus d'informations sur ce sujet, voir le commentaire de Henri Sivonen sur ce changement. Vous pouvez aussi voir la partie pertinente de la norme, qui précise quelles parties de l'API sont sensibles à la casse et quelles parties ne le sont pas.

Avant Firefox 19, cette méthode retournait une NodeList ; elle a ensuite été modifiée pour refléter le changement de spécification.

 

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : loella16, fscholz, teoli, khalid32, tregagnon, BenoitL, Fredchat
Dernière mise à jour par : loella16,