HTMLCollection | NN 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 | ||
|
||
Méthodes spécifiques à l´objet | ||
|
||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||
Aucune. |
length | NN 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 | |
|
|
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 | |
|
|
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. |