tr | NN 6 IE 4 DOM 1 | |||||||||||
L'objet tr représente l'élément tr. Du fait d´une implémentation incomplète, IE 4 pour Mac n´offre pas un accès complet par script à ces objets éléments. |
||||||||||||
Equivalent HTML | ||||||||||||
<tr> |
||||||||||||
Référence de modèle d'objet | ||||||||||||
[window.]document.getElementById("elementID") [window.]document.getElementById("tableID").rows[i] |
||||||||||||
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 la ligne. |
|
Exemple | |
document.getElementById("myTR").align = "center"; |
|
Valeur | |
L'une des constantes d'alignement horizontal suivantes: center | left | right. |
|
Par défaut | |
left |
bgColor | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Spécifie la couleur d'arrière-plan des cellules du tableau dans la ligne active. 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("myTR").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. |
borderColor | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Spécifie la couleur de la bordure de l´élément. Internet Explorer applique la couleur aux quatre lignes de la bordure d'une cellule. Par conséquent, les couleurs de cellules adjacentes ne se touchent pas. |
|
Exemple | |
document.getElementById("myTR").borderColor = "salmon"; |
|
Valeur | |
Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées. |
|
Par défaut | |
Varie selon le système d'exploitation. |
borderColorDark, borderColorLight | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
L'effet tridimensionnel des bordures d'un tableau dans Internet Explorer est créé par un agencement minutieux de lignes claires et foncées sur le fond ou la couleur par défaut de la page. Vous pouvez contrôler individuellement les couleurs utilisées pour les lignes claires et foncées en affectant des valeurs aux propriétés borderColorDark (bords gauche et supérieur de la cellule) et borderColorLight (bords droit et inférieur). |
|
En général, l'utilisateur affecte des couleurs complémentaires à la paire de propriétés. Toutefois rien ne vous oblige à définir une couleur foncée pour borderColorDark. Comme les attributs ne contrôlent qu'un jeu de lignes bien défini, vous pouvez aisément déterminer les lignes de bordure qui changeront avec chaque attribut. |
|
Exemple | |
document.getElementById("myTR").borderColorDark = "blue"; document.getElementById("myTR").borderColorLight = "cornflowerblue"; |
|
Valeur | |
Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées. |
|
Par défaut | |
Varie selon le système d'exploitation. |
cells[] | NN 6 IE 4 DOM 1 |
Lecture seule | |
Renvoie une collection de tous les objets td ou th imbriqués dans la ligne du tableau. Les éléments de cette collection sont triés selon l'ordre du code source. |
|
Exemple | |
var allRowCells = document.getElementById("myTR").cells; |
|
Valeur | |
Référence à un objet de collection cells. |
|
Par défaut | |
Tableau de longueur zéro. |
ch | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Définit le caractère utilisé comme point d´alignement pour les cellules de texte de la ligne. 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("myTR").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("myTR").chOff = "80%"; |
|
Valeur | |
Valeur, sous la forme de chaîne, du nombre de pixels ou pourcentage (dans la cellule). |
|
Par défaut | |
Aucune. |
height | NN s.o. IE 5 DOM s.o. |
Lecture/écriture | |
Spécifie la hauteur de le ligne en pixels ou pourcentage. Pour changer dynamiquement la hauteur d´une ligne, modifiez la valeur style.height de l´élément au lieu de la propriété height. |
|
Valeur | |
Valeur, sous la forme de chaîne, du nombre de pixels ou pourcentage (dans la ligne). |
|
Par défaut | |
Aucune. |
rowIndex | NN 6 IE 4 DOM 1 |
Lecture seule | |
Renvoie un nombre entier à base zéro représentant la position de la ligne active par rapport à tous les autres éléments tr du tableau. Ce nombre dépend de l'ordre des éléments tr dans le code source. |
|
Exemple | |
var whichRow = document.getElementById("myTR").rowIndex; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
Aucune. |
sectionRowIndex | NN 6 IE 4 DOM 1 |
Lecture seule | |
Renvoie un nombre entier à base zéro représentant la position de la ligne active par rapport à tous les autres éléments tr du groupe de lignes. Un groupe de lignes peut être l´un des éléments suivants: thead, tbody, tfoot. Ce nombre dépend de l'ordre des éléments tr dans le code source. |
|
Exemple | |
var whichRow = document.getElementById("myTR").sectionRowIndex; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
Aucune. |
vAlign | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique l´alignement vertical du texte des cellules de la ligne active. |
|
Exemple | |
document.getElementById("myTR").vAlign = "baseline"; |
|
Valeur | |
Constante non sensible à la casse sous forme de chaîne: baseline | bottom | middle | top. |
|
Par défaut | |
middle |
deleteCell() | NN 6 IE 4 DOM 1 |
deleteCell(index) | |
Supprime un élément td ou th imbriqué dans l´élément tr courant. La valeur sous forme de nombre entier pointe sur l´élément à base zéro dans la collection rows de la ligne. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
insertCell() | NN 6 IE 4(Win) DOM 1 |
insertCell(index) | |
Insère un élément td imbriqué dans l´élément tr courant. Le paramètre sous forme de nombre entier pointe sur l´endroit de l´index à base zéro dans la collection cells où la nouvelle cellule doit être insérée, mais dans IE vous pouvez aussi ajouter la valeur raccourcie -1 pour ajouter la cellule à la fin d´une collection. L´ajout de la cellule insère un élément vide, auquel vous ajoutez du contenu par le biais des diverses techniques de modification de l´arborescence de documents. 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 cellule nouvellement insérée. |
focus() | NN 2 IE 3 DOM 1 |
Donne l'activation à partir de l'objet courant, moment auquel l'événement onfocus de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode focus() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . |
|
Pour activer une zone de texte et présélectionner tout le texte de la zone, utilisez la séquence des méthodes focus() et select() sur l'élément. Si cette séquence doit se produire après un changement de fenêtre (par exemple, après la fermeture d'une boîte de dialogue d'alerte), placez les méthodes dans une fonction indépendante et invoquez cette méthode par le biais de la méthode setTimeout() après la méthode alert() de la boîte de dialogue. Cela permet à IE pour Windows d'exécuter les instructions dans l'ordre correct. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Aucune. |
clientHeight, clientWidth | NN 7 IE 4 DOM s.o. |
Lecture seule | |
En gros, ces propriétés fournissent la hauteur et la largeur du contenu de l'élément, mais avec quelques variations mineures dans le remplissage de l'élément selon les versions du système d'exploitation de Microsoft Internet Explorer et les modes de compatibilité contrôlés par la déclaration DOCTYPE . Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour Netscape 7, les valeurs sont de zéro, sauf quand le contenu d'un élément dépasse de la zone visible, auquel cas les valeurs révèlent les dimensions de la zone visible (par exemple, la zone de contenu de la fenêtre du navigateur pour l'élément document.body ). Pour en savoir plus, reportez-vous à la section 9.2 au début de ce chapitre. |
|
Exemple | |
var midHeight = document.body.clientHeight/2; |
|
Valeur | |
Valeur en pixels (nombre entier). |
|
Par défaut | |
0 |
blur() | NN 2 IE 3 DOM 1 |
Supprime l'activation de l'objet courant, moment auquel l'événement onblur de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode blur() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . L'affectation de l'attribut onfocus="this.blur();" à un élément input texte, par exemple, est une façon grossière mais efficace en matière de compatibilité ascendante de désactiver un champ pour les navigateurs ne fournissant pas de véritable désactivation d'éléments. |
|
Utilisez les méthodes blur() et focus() avec modération sur la même page. Vous pouvez déclencher des boucles d'activation et de fondu infinies par accident si des boîtes de dialogue d'alerte sont impliquées à un moment ou à un autre. De plus, sachez que lorsque vous invoquez la méthode blur() sur un objet, un autre objet (peut-être l'objet window ) reçoit un événement onfocus . |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Aucune. |