tbody, tfoot, theadNN 6 IE 4 DOM 1

Les objets tbody, tfoot et thead représentent les éléments tbody, tfoot et thead, respectivement. A des fins de création de scripts, vous pouvez traiter chacun de ces objets comme un conteneur de groupes de lignes dans un tableau. Ils partagent tous les mêmes propriétés et méthodes, alors il est important de ne pas confondre leur fonctionnalité HTML lorsque vous définissez ces éléments par script. Un tableau ne peut avoir qu´un élément tfoot et qu´un élément thead, mais plusieurs éléments tbody. De plus, par défaut, Internet Explorer 4 ou versions ultérieures et Netscape 6 créent un objet tbody pour chaque tableau, même si vous n´en incluez pas dans le code source de votre tableau. Cet élément tbody par défaut englobe toutes les lignes du tableau (sauf celles que vous avez incluses dans les éléments thead ou tfoot, le cas échéant). Bien que ces objets soient implémentés dans IE 4 pour Mac, ils sont incomplets. De plus, les opérations d´insertion de lignes notées dans l´élément table sont tout aussi étranges pour ces objets sous IE 4 pour Mac.

 
Equivalent HTML
 
<tbody>
<tfoot>
<thead>
 
Référence de modèle d'objet
 
[window.]document.getElementById("elementID")
[window.]document.getElementById("tableID").tBodies[i]
[window.]document.getElementById("tableID").tfoot
[window.]document.getElementById("tableID").thead
 
Propriétés spécifiques à l´objet
 
alignbgColorchchOffrowsvAlign
 
Méthodes spécifiques à l´objet
 
deleteRow()insertRow()moveRow()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

alignNN 6 IE 4 DOM 1

Lecture/écriture

Définit l'alignement horizontal du contenu de toutes les cellules de l'élément tbody.

 
Exemple
 
document.getElementById("myTbody").align = "center";
 
Valeur

L'une des trois constantes, sous forme de chaîne, d'alignement horizontal suivantes: center | left | right.

 
Par défaut

left

bgColorNN 6 IE 4 DOM s.o.

Lecture/écriture

Spécifie la couleur d'arrière-plan des cellules de l'élément tbody, tfoot ou thead. Cette couleur n'apparaît pas dans la propriété de feuille de style backgroundColor. Même si l'attribut bgcolor ou la propriété bgcolor est défini à l'aide d'un nom de couleur en anglais, la valeur renvoyée est toujours un triplet de couleurs en hexadécimal.

 
Exemple
 
document.getElementById("myTable").tHead.bgColor = "yellow";
 
Valeur

Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.

 
Par défaut

Varie selon le navigateur et le système d'exploitation.

chNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture/écriture

Définit le caractère utilisé comme point d'alignement pour le texte dans une colonne ou un groupe de colonnes (reflétant l'attribut char). Cet attribut n´est utile que si l´attribut align reçoit la valeur "char". En fait, ni IE ni Navigator ne répondent à ces propriétés.

 
Exemple
 
document.getElementById("myTBody").ch = ".";
 
Valeur

Chaîne contenant un seul caractère.

 
Par défaut

Aucune.

chOffNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture/écriture

Définit le point de décalage auquel le caractère spécifié par l´attribut char doit apparaître dans chaque cellule. En fait, ni IE ni Navigator ne répondent à ces propriétés.

 
Exemple
 
document.getElementById("myTBody").chOff = "80%";
 
Valeur

Valeur, sous la forme de chaîne, du nombre de pixels ou pourcentage (dans la cellule).

 
Par défaut

Aucune.

rowsNN 6 IE 4 DOM 1

Lecture seule

Renvoie une collection de tous les objets tr dans la section du tableau. Vous pouvez aussi obtenir un groupe de lignes pour un tableau entier dans IE pour Windows.

 
Exemple
 
var allTableRows = document.getElementById("myTFoot").rows;
 
Valeur

Référence à un objet de collection rows.

 
Par défaut

Tableau de longueur zéro.

vAlignNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie l´alignement vertical du texte dans les cellules de l'élément tbody, tfoot ou thead.

 
Exemple
 
document.getElementById("myTbody").vAlign = "baseline";
 
Valeur

Constante non sensible à la casse sous forme de chaîne: baseline | bottom | middle | top.

 
Par défaut

middle

deleteRow()NN 6 IE 4 DOM 1

deleteRow(index)

Supprime un élément tr imbriqué dans l´élément tbody, tfoot ou thead courant. La valeur sous forme de nombre entier pointe sur l´élément à base zéro dans la collection rows de la section. Pour reremplir une section de tableau avec du contenu nouveau ou trié, videz la section avec des appels itératifs à la méthode deleteRow():

while (tBodyReference.rows.length> 0) {
     tBodyReference.deleteRow(0);
}
 
Paramètres
 
  • Un nombre entier à base zéro correspondant à l´élément tr spécifié dans l'ordre du code source (imbriqué dans l´élément courant).
 
Valeur renvoyée

Aucune.

insertRow()NN 6 IE 4(Win) DOM 1

insertRow(index)

Insère un élément tr imbriqué dans l´élément tbody, tfoot ou thead courant. Le paramètre sous forme de nombre entier pointe sur l´endroit de l´index à base zéro dans la collection rows où la nouvelle ligne doit être insérée, mais dans IE vous pouvez aussi ajouter la valeur raccourcie -1 pour ajouter la ligne à la fin d´une collection. L´ajout de la ligne insère un nouvel élément, auquel vous ajoutez des cellules par le biais de la méthode insertCell(). Malheureusement, la définition de scripts pour l´ajour de lignes et de cellules de tableau dans IE pour Macintosh (y compris le version 5.1) ne fonctionne pas du tout et génère des dimensions de cellule et de ligne énormes. Pour les tableaux non imbriqués, vous pourrez peut-être utiliser la création et l´insertion de noeuds d´arborescence de documents à la place des méthodes de l´objet table.

 
Paramètres
 
  • Nombre entier à base zéro correspondant à une ligne de la collection rows avant laquelle la nouvelle ligne doit être insérée.
 
Valeur renvoyée

Référence à la ligne nouvellement insérée.

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

moveRow(indexToMove, destinationIndex)

Déplace une ligne dans l´élément tbody, tfoot ou thead de son emplacement d´origine à une position de ligne différente dans la même section. Le premier paramètre est un index à base zéro de la ligne (dans la collection rows) que vous voulez déplacer. Le deuxième paramètre est l´index de la ligne avant laquelle vous voulez placer la ligne.

 
Paramètres
 
  • Un nombre entier à base zéro pointant sur la ligne à déplacer.
  • Un nombre entier à base zéro pointant sur la ligne au-dessus de laquelle la ligne doit être placée.
 
Valeur renvoyée

Référence à la ligne déplacée.