Méthode namedItem() de XML DOM

Définition et utilisation

La méthode namedItem() récupère un nœud ou un élément avec un nom spécifié à partir du jeu.

Selon le type de document différent, le comportement de cette méthode est également différent :

  • Si le document est un document HTML, cette méthode cherchera d'abord les nœuds avec un attribut id correspondant au nom donné, s'il n'y a pas d'attribut id correspondant, elle cherchera les nœuds avec un attribut name correspondant au nom donné.

    Lors de la requête du document HTML, cette méthode n'est pas sensible à la casse.

  • Si le document est un document XHTML, cette méthode ne recherche que les nœuds avec l'attribut id correspondant au nom donné.

    Lors de la requête du document HTML, cette méthode est sensible à la casse.

Grammaire :

htmlcollectionObject.namedItem(nom)
Paramètres Description
nom Nom du nœud ou de l'élément à récupérer.

Retourne la valeur

Retourne l'élément ou le nœud avec l'attribut id ou name spécifié. Si le nœud correspondant n'existe pas dans HTMLCollection, retourne null.

Description

En JavaScript, traitez HTMLCollection comme un tableau associatif et utilisez la syntaxe de tableau pour placer le nom entre [] pour trouver des éléments, ce qui est plus facile.

Exemple

var c = document.forms;		//C'est un objet HTMLCollection
var address = c.namedItem("address");	//Chercher <form name="address">
var payment = c["payment"];		//Grammaire plus simple : chercher <form name="payment">
var login = c.login;		//C'est aussi valable : chercher <form name="login">