Objet HTMLCollection XML DOM

Objet HTMLCollection

L'HTMLCollection est une interface qui représente une collection d'éléments HTML, elle fournit des méthodes et des propriétés pour parcourir la liste.

L'HTMLCollection dans l'HTML DOM est "vivante" ; si le document de base change, ces modifications sont immédiatement affichées par tous les objets HTMLCollection.

Chaque élément suivant (et ses attributs spécifiés) renvoie une HTMLCollection :

  • Document (images, applets, links, forms, anchors)
  • form (elements)
  • map (areas)
  • select (options)
  • table (rows, tBodies)
  • tableSection (rows)
  • row (cells)

De nombreuses propriétés de l'interface HTMLDocument sont des objets HTMLCollection, fournissant un accès facile aux éléments du document tels que les formulaires, les images et les liens.form.elements et select.options sont des objets HTMLCollection. L'HTMLCollection fournit également une méthode pour Table Les lignes de TableRow une méthode spécifique pour chaque cellule.

Comme mentionné précédemment, l'objet HTMLCollection est une collection d'éléments HTML avec des méthodes, utilisée pour obtenir des éléments par leur position dans le document ou leurs attributs id et name. En JavaScript, l'objet HTMLCollection se comporte comme un tableau lecture seule, et il est possible d'indexer un objet HTMLCollection par numéro ou par nom sans appeler Méthode item()et Méthode namedItem().

L'objet HTMLCollection est lecture seule, il ne peut pas y ajouter de nouveaux éléments, même en utilisant la syntaxe de tableau JavaScript.

L'objet HTMLCollection et Objet NodeListTrès similaires, mais le premier peut être indexé à la fois par nom et par numéro.

Propriétés de l'objet HTMLCollection

Propriété Description
cssRules Propriété lecture seule, renvoyant un entier indiquant la longueur de la liste (c'est-à-dire le nombre d'éléments dans la collection).

Méthodes de l'objet HTMLCollection

Méthode Description
item() Retourne l'élément (nœud) à la position spécifiée dans la collection.
namedItem() Retourne l'élément (nœud) avec l'attribut name ou id ayant la valeur spécifiée dans la collection.

Exemple

var c = document.forms;		//C'est un objet HTMLCollection pour l'élément form
var firstform = c[0];		//Peut être utilisé comme tableau numéroté
var lastform = c[c.length-1];	//La propriété length retourne le nombre d'éléments
var address = c["address"];		//Peut être utilisé comme tableau associatif
var address = c.address;		//JavaScript permet cette notation

Pages connexes

Manuel de référence DOM XML :Objet HTMLDocument

Manuel de référence DOM XML :Objet NodeList

Manuel de référence :Manuel de référence HTML DOM