images

NN 3 IE 4 DOM 1

Collection (tableau) de tous les objets img contenus dans le document. Cet objet n'est disponible que dans les versions des navigateurs qui traitent les images comme des objets. Vous pouvez dès lors utiliser cet objet tableau comme un commutateur conditionnel entourant les instructions qui permutent ou préchargent des images:

if (document.images) {
    // process img element objects here
}

Internet Explorer 3,01 pour Macintosh prenait en charge les images sous forme d'objets.

Référence de modèle d'objet

document.images

Propriétés spécifiques à l´objet

length

Méthodes spécifiques à l´objet

item()

namedItem()

tags()

urns()

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

Exemple

var howMany = document.images.length;

Valeur
Nombre entier.

item()	NN 6 IE 4 DOM 1
item(index[, subindex]) item(index)
Renvoie un objet image ou une collection d'objets images 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 numéroté 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. Si vous spécifiez une valeur sous forme de chaîne pour le premier paramètre (IE uniquement), 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 2
namedItem(IDOrName)
Renvoie un objet 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
Référence d´un objet. 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. Redondante ici, puisque tous les éléments ont la même balise img.

Paramètres

Chaîne comprenant la balise de l'élément, comme dans document.images.tags("form").

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.