children

NN s.o. IE 4 DOM s.o.

Collection de tous les éléments contenus dans l'élément courant. Remarque: Contrairement à la collection childNodes, children ne compte que des éléments et pas de noeuds de texte. Les éléments de cette collection sont triés selon l'ordre du code source. Internet Explorer vous permet d'utiliser une notation de tableau ou des parenthèses pour accéder à un élément de la collection.

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

document.getElementById("elementID").children(i)
document.getElementById("elementID").children[i]

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 s.o. IE 4 DOM s.o.
	Lecture seule
Renvoie le nombre d'éléments de la collection.

Exemple

var howMany = document.body.children.length;

Valeur
Nombre entier.

item()	NN s.o. IE 4 DOM s.o.
item(index)
Renvoie un objet élément pour l´élément qui correspond à la valeur d´index dans l´ordre du code source.

Paramètres

Un nombre entier à base zéro correspondant à l´élément spécifié dans l'ordre du code source (imbriqué dans l´élément courant).

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 s.o. IE 6 DOM s.o.
namedItem(IDOrName)
Renvoie un objet élément ou une collection d'objets 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
Un objet élément ou une collection d'objets éléments (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 courante) dont les balises correspondent au paramètre tagName. Implémenté dans toutes les collections IE (voir la méthode all.tags()), mais redondant 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().

cite	NN 6 IE 6 DOM 1
	Lecture/écriture
Cette propriété (avec dateTime ) est partagée par tous les objets éléments de phrase dans IE 6, mais en réalité, elle appartient officiellement aux objets éléments blockquote , quote , del et ins (reportez-vous aux descriptions de ces éléments dans le chapitre 8 pour plus de détails sur l'attribut correspondant dans le contexte de l'élément). Comme la propriété est partagée par quatre objets, il est possible que Microsoft ait trouvé plus pratique de l'implémenter au niveau interne pour un ensemble plus large d'objets éléments HTML associés. Ou il peut s'agir d'une erreur. Quelle qu'en soit la raison, n'attendez pas cette propriété dans autant d'éléments qu'en présente IE 6.

Valeur
Toute adresse URL valide (absolue ou relative) d'un document sur le Web.

Par défaut
Une chaîne vide.

children[]	NN s.o. IE 4 DOM s.o.
	Lecture seule
Renvoie un tableau de tous les objets éléments HTML de premier niveau que contient l'élément courant. Cette collection diffère de la collection all[] car elle ne contient que des références aux enfants immédiats de l'élément considéré (alors que la collection all[] transcende les générations). Par exemple, document.body.children[] peut contenir un formulaire, mais aucune référence aux éléments de formulaire au sein de ce formulaire. Les éléments de ce tableau sont indexés (en base zéro) dans l'ordre dans lequel ils apparaissent dans le code source. Contrairement au tableau childNodes[] , la portée de cette propriété est l'élément, pas le noeud. Voir l'objet children .

Exemple

for (var i = 0; i < elementRef.children.length; i++) { if (elementRef.children[i].tagName == "FORM") { // operate on a form element } }

Valeur
Tableau des références des objets éléments.

Par défaut
Tableau de longueur zéro.