linksNN 2 IE 3 DOM 1

Collection de tous les éléments a et area qui se comportent comme des liens (et non des ancres) en raison des attributs href qui leur sont affectés. Les éléments de cette collection sont triés selon l'ordre du code source. Navigator et Internet Explorer vous permettent d'utiliser une notation de tableau pour accéder à un lien de la collection (par exemple document.links[0] ou document.links["section3"]). Si vous voulez utiliser le nom du lien comme valeur d'index (toujours sous forme d'identifiant de chaîne), utilisez la valeur de l'attribut name plutôt que celle de l'attribut id. Pour utiliser l'attribut ID dans une référence à une ancre, accédez à l'objet via la référence document.all.elementID (dans IE uniquement) ou la référence document.getElementById("elementID").

 
Référence de modèle d'objet
  
document.links
 
Propriétés spécifiques à l´objet
 
length
 
Méthodes spécifiques à l´objet
 
item()namedItem()tags()urns()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

lengthNN 2 IE 3 DOM s.o.

Lecture seule

Renvoie le nombre d'éléments de la collection.
 
Exemple
  
var howMany = document.links.length;
 
Valeur

Nombre entier.

item()NN 6 IE 4 DOM 1

item(index) item(index[, subindex])

Renvoie un objet ou une collection d'objets pour l'élément correspondant à la valeur d'index (ou, éventuellement dans IE pour Windows, aux valeurs d'index et de sous-index).

 
Paramètres
 
  • Lorsque le paramètre est un nombre entier à base zéro (requis dans Netscape 6), la valeur renvoyée est un seul élément qui correspond à l´élément numéroté spécifié dans l´ordre du code source (imbriqué dans l´élément actuel). Lorsque le paramètre est une chaîne (autorisée par IE pour Windows), la valeur renvoyée est une collection d´éléments dont les propriétés id ou name correspondent à cette chaîne.
  • Si vous spécifiez une valeur sous forme de chaîne pour le premier paramètre (dans IE pour Windows), vous pouvez utiliser le second pour spécifier un nombre entier à base zéro afin d'extraire un élément spécifique de la collection dont les propriétés id ou name correspondent à la valeur contenue dans la chaîne du premier paramètre.
 
Valeur renvoyée

Objet ou collection d'objets (tableau). A défaut de correspondance avec les paramètres, la valeur renvoyée est null.

namedItem()NN 6 IE 6 DOM 1

namedItem(IDOrName)

Renvoie un objet ou une collection d'objets (dans Netscape 6) pour l'élément correspondant à la valeur de chaîne de paramètre.

 
Paramètres
 
  • La chaîne contenant la même valeur que l´attribut id ou name de l´élément désiré.
 
Valeur renvoyée

Objet (dans Netscape 6) ou collection d'objets (tableau). A défaut de correspondance avec les paramètres, la valeur renvoyée est null.

tags()NN s.o. IE 4 DOM s.o.

tags(tagName)

Renvoie une collection d'objets (parmi tous les objets imbriqués dans la collection actuelle) dont les balises correspondent au paramètre tagName. Vous permet de faire la distinction entre les collections d´éléments a et area.

 
Paramètres
 
  • Chaîne comprenant la balise de l'élément, comme dans document.links.tags("a").
 
Valeur renvoyée

Collection d'objet (un tableau). S'il n'existe aucune correspondance avec les paramètres, la valeur renvoyée est un tableau de longueur zéro.

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

urns(URN)

Renvoie une collection d'objets éléments imbriqués auxquels des comportements sont rattachés et dont les URN correspondent au paramètre URN.

 
Paramètres
 
  • Une chaîne avec un URN de fichier de comportement local ou externe.
 
Valeur renvoyée

Collection d'objet (un tableau). S'il n'existe aucune correspondance avec les paramètres, la valeur renvoyée est un tableau de longueur zéro.