anchors

NN 2 IE 3 DOM 1

Collection de tous les éléments a qui se comportent comme des ancres (et non des liens) en raison des attributs name 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 à une ancre de la collection (par exemple, document.anchors[0], document.anchors["section3"]). Internet Explorer 4 vous permet également de remplacer les crochets qui entourent la valeur d'index par des parenthèses (par exemple, document.anchors(0)). Si vous voulez utiliser le nom de l'ancre comme valeur d'index (sous forme d'identifiant de chaîne), utilisez la valeur de l'attribut name plutôt que l'attribut id. Pour utiliser l'attribut ID dans une référence à une ancre, accédez à l'objet par le biais de 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.anchors

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.

length	NN 2 IE 3 DOM 1
	Lecture seule
Renvoie le nombre d'éléments de la collection.

Exemple

var howMany = document.anchors.length;

Valeur
Nombre entier.

item()	NN 6 IE 4 DOM 1
item(index[, subindex]) item(index)
Renvoie un objet ancre ou une collection d'objets ancres pour l'élément correspondant à la valeur d'index (ou éventuellement, dans IE, aux valeurs index et subindex).

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 spécifié dans l´ordre du code source (imbriqué dans l´élément actuel). Lorsque le paramètre est une chaîne, la valeur renvoyée est une collection d´éléments dont les propriétés id ou name correspondent à cette chaîne. Dans IE uniquement, si vous spécifiez une valeur sous forme de chaîne pour le premier paramètre, 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 ancre ou collection d'objets ancres (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 ancre ou une collection d'objets ancres 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 ancre ou collection d'objets ancres (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. Implémentée dans toutes les collections IE (voir la méthode all.tags()), mais redondante pour les collections du même type d´élément.

urns()	NN s.o. IE 5 (Win) DOM s.o.
urns(URN)
Reportez-vous à la méthode all.urns().