td, th | NN 6 IE 4 DOM 1 | |||||||||||||||||||
Les objets td et th représentent les éléments td et th. Du point de vue de la structure HTML, les deux éléments ont des buts différents dans un tableau; mais du point de vue de la création de scripts, ils partagent les mêmes propriétés et méthodes. Une cellule est une cellule. |
||||||||||||||||||||
S'il est vrai qu´un élément de cellule de tableau peut hériter de différentes propriétés visuelles en provenance de conteneurs (par exemple, un élément td semble hériter de la propriété bgColor d'un élément tbody ou tr), ces valeurs de propriété héritées ne sont pas automatiquement affectées à l'objet td. Par conséquent, le fait qu'une cellule ait un fond jaune, ne signifie pas que sa propriété bgColor ait été définie. 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 | ||||||||||||||||||||
<td> <th> |
||||||||||||||||||||
Référence de modèle d'objet | ||||||||||||||||||||
[window.]document.getElementById("elementID") [window.]document.getElementById("tableRowID").cells[i] |
||||||||||||||||||||
Propriétés spécifiques à l´objet | ||||||||||||||||||||
|
||||||||||||||||||||
Méthodes spécifiques à l´objet | ||||||||||||||||||||
Aucune. |
||||||||||||||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||||||||||||||
Aucune. |
ABBR | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Représente l´attribut abbr (description de la cellule pour la parole), pour lequel les navigateurs courants n´ont aucune fonctionnalité à l´heure actuelle. |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Une chaîne vide. |
align | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Définit l'alignement horizontal du contenu de la cellule. |
|
Exemple | |
document.getElementById("myTD").align = "center"; |
|
Valeur | |
L'une des constantes d'alignement horizontal suivantes: center | left | right. |
|
Par défaut | |
left |
axis | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Représente l´attribut axis (description de la catégorie de cellule pour la parole), pour lequel les navigateurs courants n´ont aucune fonctionnalité à l´heure actuelle. |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Une chaîne vide. |
background | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Spécifie l´adresse URL de l'image d'arrière-plan pour la cellule. Si vous définissez également une propriété bgColor pour l'élément, la couleur s'affiche en cas d'échec de chargement de l'image. Dans le cas contraire, l'image recouvre la couleur. |
|
Exemple | |
document.getElementById("myTD").background = "images/watermark.jpg"; |
|
Valeur | |
Toute adresse URL complète ou relative pointant sur le fichier image d'arrière-plan. |
|
Par défaut | |
Aucune. |
bgColor | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Définit la couleur d'arrière-plan de la cellule du tableau. 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("myTD").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("myTD").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("myTD").borderColorDark = "blue"; document.getElementById("myTD").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. |
cellIndex | NN 6 IE 4 DOM 1 |
Lecture seule | |
Renvoie un nombre entier à base zéro représentant la position de la cellule courante par rapport à tous les autres éléments td de la même ligne. Le nombre dépend de l'ordre de code source des éléments td dans un élément tr. Cette propriété n'est pas disponible dans la version Macintosh de Microsoft Internet Explorer 4. |
|
Exemple | |
var whichCell = document.getElementById("myTD").cellIndex; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
Aucune. |
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 cellule. 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("myTD").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("myTD").chOff = "80%"; |
|
Valeur | |
Valeur, sous la forme de chaîne, du nombre de pixels ou pourcentage (dans la cellule). |
|
Par défaut | |
Aucune. |
colSpan | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Spécifie le nombre de colonnes du tableau sur lequel la cellule doit s'étendre. Chaque colonne supplémentaire incluse dans le nombre colSpan implique un élément td de moins dans la ligne du tableau. Si vous paramétrez la propriété align sur center ou sur right, l'alignement est calculé pour toute la largeur de l'élément td sur le nombre de colonnes indiqué. La ligne suivante du tableau retrouve le nombre de colonnes original à moins que vous ayez précisé un attribut rowspan. |
|
Exemple | |
document.getElementById("myTD").colSpan = 2; |
|
Valeur | |
Nombre entier, généralement égal ou supérieur à deux. |
|
Par défaut | |
1 |
filters[] | NN s.o. IE 4 DOM s.o. |
Renvoie un tableau de tous les objets filter que contient l´élément courant. Ne s´applique qu´aux objets éléments suivants: bdo , body , button , div , fieldset , img , input , marquee , rt , ruby , span , table , td , textarea et th . Voir l'objet filter pour la syntaxe de référencement. |
|
Valeur | |
Tableau des références des objets filter . |
|
Par défaut | |
Tableau de longueur zéro. |
headers | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Pointe sur l´ID de l´élément de cellule du tableau désigné comme en-tête de colonne pour la cellule courante. En pratique, aucun navigateur courant ne fournit de fonctionnalité pour cette propriété. |
|
Valeur | |
Valeur d´ID sous forme de chaîne. |
|
Par défaut | |
Aucune. |
height, width | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Fournit la hauteur et la largeur de l'élément. La modification de ces valeurs se reflète immédiatement dans l'actualisation du contenu de la page. Ces propriétés sont en lecture seule dans la version Macintosh de Microsoft Internet Explorer 4. |
|
Exemple | |
document.getElementById("myTD").height = "250"; |
|
Valeur | |
Nombre entier en pixels (sous forme de chaîne) ou pourcentage. |
|
Par défaut | |
Aucune. |
noWrap | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique si le navigateur doit élargir une cellule pour permettre l'affichage d'une ligne de texte insécable sur une seule ligne. Il est conseillé de ne pas abuser de cet attribut, car il oblige l´utilisateur à faire défiler horizontalement la page pour en afficher tout le contenu. |
|
Exemple | |
document.getElementById("myTD").noWrap = "true"; |
|
Valeur | |
Valeur booléenne: true | false. |
|
Par défaut | |
false |
rowSpan | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Spécifie le nombre de lignes sur lequel la cellule active doit s'étendre vers le bas. Pour chaque ligne supplémentaire incluse dans le nombre rowSpan, il faut un élément td de moins pour la ligne suivante du tableau. Si vous paramétrez la propriété vAlign sur middle, l'alignement est calculé par rapport à la hauteur totale de l'élément td sur le nombre de lignes spécifié. |
|
Exemple | |
document.getElementById("myTD").rowSpan = 12; |
|
Valeur | |
Nombre entier, généralement égal ou supérieur à deux. |
|
Par défaut | |
1 |
scope | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Représente l´attribut de portée des éléments de la cellule de tableau. En pratique, aucun navigateur courant ne fournit de fonctionnalité pour cette propriété. |
|
Valeur | |
L'une des constantes, sous forme de chaîne, reconnues: cols | colgroup | rows | rowgroup. |
|
Par défaut | |
Aucune. |
vAlign | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Spécifie le mode d'alignement de texte vertical dans la zone de contenu de l'élément. |
|
Exemple | |
document.getElementById("myTD").vAlign = "baseline"; |
|
Valeur | |
Constante non sensible à la casse sous forme de chaîne: baseline | bottom | middle | top. |
|
Par défaut | |
middle |
width | |
Voir height. |
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. |