tbody, tfoot, thead | NN 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 | ||||||
|
||||||
Méthodes spécifiques à l´objet | ||||||
|
||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||
Aucune. |
align | NN 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 |
bgColor | NN 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. |
ch | NN 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. |
chOff | NN 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. |
rows | NN 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. |
vAlign | NN 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 | |
|
|
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 | |
|
|
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 | |
|
|
Valeur renvoyée | |
Référence à la ligne déplacée. |