rows

NN 6 IE 4 DOM 1

Fournit une collection de tous les objets éléments tr contenus dans un seul élément objet table, tbody, tfoot ou thead. La collection rows d'un élément table inclut toutes les lignes d'un tableau, indépendamment des groupes de lignes. 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 à une ligne unique de la collection (par exemple document.getElementById("myTable").rows[0], document.all.myTable.rows (0))).

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

document.getElementById("tableOrSectionID").rows

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

Exemple

var howMany = document.getElementById("myTable").rows.length;

Valeur
Nombre entier.

item()	NN 6 IE 4 DOM 1
item(index[, subindex]) item(index)
Renvoie un objet tr ou une collection d'objets tr 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, la valeur renvoyée est un élément unique correspondant à l'élément spécifié dans l'ordre du code source (imbriqué dans le document courant); lorsque le paramètre est une chaîne (IE uniquement), la valeur renvoyée constitue une collection d'éléments dont les propriétés id 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 correspondent à la valeur contenue dans la chaîne du premier paramètre.

Valeur renvoyée
Un objet tr ou une collection (tableau) d´objets tr. A défaut de correspondance avec les paramètres, la valeur renvoyée est null.

namedItem()	NN 6 IE 6 DOM 1
namedItem(ID)
Renvoie un objet tr ou une collection d'objets tr 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 de l´élément désiré.

Valeur renvoyée
Un objet tr ou une collection (tableau) d´objets tr. 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 tr.

Paramètres

Chaîne comprenant les balises de l'élément en majuscules, comme dans document.getElementById("myTable").rows.tags("tr").

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)
Reportez-vous à la méthode all.urns().