attributes, NamedNodeMapNN 6 IE 5 DOM 1

L´objet renvoyé par la propriété attributes de chaque objet élément du DOM W3C est une collection (tableau) de références aux objets Attr (ou attribute). Un nom est toujours associé à un type d´attribut de noeud, ce qui permet aux méthodes de collection de tels noeuds d´y accéder directement par nom, au lieu de lancer une recherche itérative dans le tableau afin de trouver un nom de noeud correspondant. Dans la structure du DOM W3C, la représentation abstraite de ce tableau de noeuds nommés s´appelle l´objet NamedNodeMap, qui partage certaines propriétés et méthodes de l´objet attributes de Microsoft Internet Explorer. Puisque ces deux objets font référence aux mêmes parties d´une arborescence de documents, nous les aborderons conjointement. Quelques autres collections du DOM W3C sont aussi du type NamedNodeMap, mais votre contact principal avec NamedNodeMap dans les documents HTML est sous la forme d´une collection d´objets Attr. Les éléments de cette collection sont triés selon l'ordre du code source.

 

Il existe des façons plus directes d´accéder à l´attribut d´un élément (telles que les méthodes getAttribute() ou getAttributeNode() de tous les éléments). Cependant, la propriété et les méthodes illustrées ici supposent que votre script a reçu une collection d´attributs indépendants de leur élément hôte et que votre traitement commence à ce point précis.

 
Référence de modèle d'objet
  
elementReference.attributes
 
Propriétés spécifiques à l´objet
 
length
 
Méthodes spécifiques à l´objet
 
getNamedItem()getNamedItemNS()item()removeNamedItem()
removeNamedItemNS()setNamedItem()setNamedItemNS()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

getExpression()NN s.o. IE 5 (Win) DOM s.o.

getExpression("attributeName")

Renvoie une version sous forme de chaîne de l´expression du script utilisée dans un appel de méthode setExpression() correspondant sur un attribut de l´élément courant. La méthode setExpression() affecte une expression de script utilisée pour calculer la valeur affectée à l´attribut. L´expression est calculée automatiquement en réponse à certains types d´événements et à la méthode document.recalc() . Pour lire la valeur courante de l´attribut, vous devez lire la fonction eval() sur la chaîne renvoyée par la méthode getExpression() . Reportez-vous à la méthode setExpression() plus loin dans cette section.

 
Paramètres
 
  • Nom de l´attribut de l´élément considéré auquel une expression est affectée par la méthode setExpression() .
 
Valeur renvoyée

Chaîne.
lengthNN 6 IE 5 DOM 1

Lecture seule

Renvoie le nombre d'éléments de la collection.
 
Exemple
  
var howMany = document.getElementById("myTable").attributes.length;
 
Valeur

Nombre entier.

getNamedItem()NN 6 IE 6 DOM 1

getNamedItem("attributeName")

Renvoie un objet Attr pour l´attribut dont le nom de noeud correspond à la valeur du paramètre.

 
Paramètres
 
  • Chaîne correspondant à la partie « nom » de la paire nom/valeur de l´attribut.
 
Valeur renvoyée

Référence à un objet Attr. A défaut de correspondance avec la valeur du paramètre, la valeur renvoyée est null.

getNamedItemNS()NN 6 IE s.o DOM 2

getNamedItemNS("namespaceURI", "localName")

Returns a single Renvoie un seul objet Attr avec nom local et URI d´espace de nom correspondant aux valeurs de paramètres.

 
Paramètres
 
  • Chaîne d´URI correspondant à une URI affectée précédemment à une étiquette dans le document.
  • La partie du nom local de l´attribut.
 
Valeur renvoyée

Référence à un objet Attr. A défaut de correspondance avec les valeurs de paramètres, la valeur renvoyée est null.

item()NN 6 IE 5 DOM 1

item(index)

Renvoie un objet Attr pour l´élément qui correspond à la valeur d´index.

 
Paramètres
 
  • Un nombre entier à base zéro correspondant à l´élément spécifié dans l'ordre du code source.
 
Valeur renvoyée

Référence à un objet Attr. A défaut de correspondance avec la valeur d´index, la valeur renvoyée est null. Contrairement à d´autres collections dans IE, une valeur d´index sous la forme de chaîne n´est pas autorisée pour l´objet attributes.

removeNamedItem()NN 6 IE 6 DOM 1

removeNamedItem("attributeName")

Renvoie à partir de la collection un objet Attr pour l´attribut dont le nom de noeud correspond à la valeur du paramètre.

 
Paramètres
 
  • Chaîne correspondant à la partie « nom » de la paire nom/valeur de l´attribut.
 
Valeur renvoyée

Référence à l´objet Attr supprimé. A défaut de correspondance avec la valeur du paramètre, la valeur renvoyée est null.

removeNamedItemNS()NN 6 IE s.o DOM 2

removeNamedItemNS("namespaceURI", "localName")

Renvoie à partir de la collection un objet Attr dont le nom local et l´URI d´espace de nom correspondent aux valeurs de paramètres.

 
Paramètres
 
  • Chaîne d´URI correspondant à une URI affectée précédemment à une étiquette dans le document.
  • La partie du nom local de l´attribut.
 
Valeur renvoyée

Référence à l´objet Attr supprimé. A défaut de correspondance avec les valeurs de paramètres, la méthode génère une erreur.

setNamedItem()NN 6 IE 6 DOM 1

setNamedItem(attrObjectReference)

Insère un objet Attr dans la collection d´attributs actuelle. Si la destination de l´attribut est un élément existant, vous pouvez aussi utiliser la méthode setAttributeNode() sur l´élément afin d´insérer l´objet Attr. Lorsque la méthode setNamedItem() est invoquée, le navigateur commence par rechercher une correspondance entre le nom du nouvel attribut et les noms d´attributs existants dans la collection. Si une correspondance existe, le nouvel attribut remplace l´attribut d´origine; sinon, le nouvel attribut est ajouté à la collection.

 
Paramètres
 
  • Référence à un objet de noeud Attr créé avec document.createAttribute() ou un noeud Attr d´un autre élément de l´arborescence de documents.
 
Valeur renvoyée

Référence à un objet Attr nouvellement créé ou référencé à un autre endroit de l´arborescence de documents.

setNamedItemNS()NN 6 IE s.o DOM 2

setNamedItemNS(attrObjectReference)

Insère un objet Attr dans la collection d´attributs actuelle. Si la destination de l´attribut est un élément existant, vous pouvez aussi utiliser la méthode setAttributeNodeNS() sur l´élément afin d´insérer l´objet Attr. Lorsque la méthode setNamedItemNS() est invoquée, le navigateur commence par rechercher une correspondance entre le nom local et l´URI d´espace de nom du nouvel attribut et les noms locaux et URI d´espace de nom des attributs existants dans la collection. Si une correspondance existe, le nouvel attribut remplace l´attribut d´origine; sinon, le nouvel attribut est ajouté à la collection.

 
Paramètres
 
  • Référence à un objet de noeud Attr créé avec document.createAttributeNS() ou à un noeud Attr d´un autre élément de l´arborescence de documents.
 
Valeur renvoyée

Référence à un objet Attr nouvellement créé ou référencé à un autre endroit de l´arborescence de documents.