caption

NN 6 IE 4 DOM 1

L´objet caption représente l´élément caption, qui doit toujours être imbriqué dans un élément table. IE pour Mac implémente les ensembles de propriétés client et de défilement pour cet objet.

Equivalent HTML

<caption>

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

[window.]document.getElementById("elementID")

Propriétés spécifiques à l´objet

align

vAlign

Méthodes spécifiques à l´objet

Aucune.

Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

align	NN 6 IE 4 DOM 1
	Lecture/écriture
Détermine la position de la légende d'un tableau. Reportez-vous à l´attribut align de l´élément caption dans le chapitre 8 pour plus de détails au sujet de l´interaction entre les attributs et propriétés align et vAlign dans IE pour Windows. Le DOM W3C utilise la propriété align essentiellement pour positionner la légende au-dessus ou au-dessous du tableau.

Exemple

document.getElementById("myCaption").align = "bottom";

Valeur
L'une des constantes suivantes (sous forme de chaîne): bottom \| left \| right \| top.

Par défaut
top

vAlign	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Spécifie si la légende du tableau apparaît au-dessus ou au-dessous du tableau.

Exemple

document.getElementById("tabCaption").vAlign = "bottom"

Valeur
Constante (sous forme de chaîne) non sensible à la casse: bottom \| top.

Par défaut
top

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

clientLeft, clientTop	NN s.o. IE 4 DOM s.o.
	Lecture seule
En gros, ces propriétés fournissent les coordonnées gauche et supérieure du contenu de l'élément dans le cadre qui inclut le remplissage de l'élément, mais avec des variations mineures selon les versions du système d'exploitation de Microsoft Internet Explorer. Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour en savoir plus, reportez-vous à la section 9.2 au début du présent chapitre. Des informations plus utiles sur le positionnement des éléments internes proviennent généralement des propriétés offsetLeft et offsetTop (y compris dans Netscape 6). Pour les éléments positionnés par CSS (y compris la modification de la position d'un élément), utilisez les propriétés de l'objet style , telles que left et top , et (dans IE uniquement) pixelLeft et pixelTop .

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.