HTMLCollectionNN 6 IE 5(Mac)/6(Win) DOM 1

L´objet HTMLCollection est une représentation abstraite dans le DOM W3C de n´importe quelle collection d´objets éléments HTML, qui existent tous dans la même arborescence de documents et ont la même balise. Par exemple, aux yeux du DOM W3C, le tableau document.images est un objet HTMLCollection. Toutes les entrées sont des références des objets éléments img. JavaScript traite de telles collections comme des tableaux pour l´accès aux entrées individuelles avec la notation de tableau, et l´aide de la seule propriété de HTMLCollection, length. Vous pouvez aussi utiliser les deux méthodes (item() et namedItem()) pour référencer une seule entrée de la collection. Toutes les instances de l´objet HTMLCollection (telles que document.images) héritent des propriétés et de la méthode répertoriées ci-dessous à partir de l´objet HTMLCollection abstrait. Reportez-vous aux descriptions de chaque instance dans ce chapitre (anchors, applets, areas, cells, elements, forms, images, links, options, rows, tBodies, et les elements de collection non DOM W3C all, children, embeds et frames).

 
Propriétés spécifiques à l´objet
 
length
 
Méthodes spécifiques à l´objet
 
item()namedItem()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

lengthNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture seule

Renvoie le nombre d'éléments de la collection.

 
Exemple
 
var howMany = document.myForm.elements.length;
 
Valeur

Nombre entier.

item()NN 6 IE 5(Mac)/6(Win) DOM 1

item(index)

Renvoie un objet de la collection pour l´objet qui correspond à la valeur d´index dans l´ordre du code source. IE implémente une autre variante de cette méthode pour certaines (pas toutes) de ses collections avec paramètre secondaire facultatif.

 
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 élément. A défaut de correspondance avec le paramètre, la valeur renvoyée est null.

namedItem()NN 6 IE 5(Mac)/6(Win) DOM 1

namedItem(IDOrName)

Renvoie un objet de la collection pour l´objet qui correspond à la valeur de chaîne de paramètre.

 
Paramètres
 
  • La chaîne contenant la même valeur que le nom du filtre désiré.
 
Valeur renvoyée

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