body

NN 6 IE 4 DOM 1

L'objet body représente l'élément body, distinct de l'objet document. L'objet body fait uniquement référence à l'élément et à son contenu imbriqué. Il ne peut y avoir qu´un seul élément body dans une page HTML, et les DOM IE et W3C fournissent donc une référence de raccourci vers l´objet, document.body. Les gestionnaires d´événements répertoriés ici apparaissent comme attributs dans la balise <body>, mais il s´agit en fait d´événements de niveau document (qu´il vaut mieux référencer sous la forme de propriétés comme document.eventName). Comme IE pour Mac ne partage pas les ensembles de propriétés de client et de défilement avec tous les objets éléments, ces propriétés sont définies pour l´objet body.

En essayant de mettre en place le mode compatible avec les normes dans IE 6 pour Windows (reportez-vous à l´élément DOCTYPE dans le chapitre 8), Microsoft a annulé la vieille astuce consistant à utiliser les propriétés clientHeight et clientWidth de l´élément body pour obtenir l´équivalent des propriétés window.innerHeight et window.innerWidth de Netscape. En mode compatible avec les normes (où document.compatMode == "CSS1Compat"), vous devez utiliser les propriétés clientHeight et clientWidth de l´élément html pour trouver ces valeurs. Utilisez ces raccourcis de référence très efficaces:

document.body.parentNode.clientHeight
document.body.parentNode.clientWidth

Equivalent HTML

<body>

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

[window.]document.body

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

alink	background	bgColor	bgProperties	bottomMargin
leftMargin	link	noWrap	rightMargin	scroll
text	topMargin	vLink

Méthodes spécifiques à l´objet

createTextRange()

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

Gestionnaire	IE pour Windows	IE pour Mac	NN	DOM W3C
onafterprint	5	s.o	s.o	s.o
onbeforeprint	5	s.o	s.o	s.o
onbeforeunload	4	s.o	s.o	s.o
onload	3	3.01	2	2
onselect	s.o	s.o	6	s.o
onunload	3	3.01	2	2

aLink	NN 6 IE 4 DOM 1
	Lecture/écriture
Indique une couleur du lien hypertexte lors du clic sur ce lien. La couleur choisie est appliquée au texte du lien ou à sa bordure, dans le cas d'une image ou d'un objet imbriqué dans un élément a. Voir également les propriétés link et vLink pour plus d'informations sur la couleur des liens visités et non visités. La version qui assure la compatibilité ascendante de cette propriété, bien que délaissée, est la propriété alinkColor de l´objet document.

Exemple

document.body.aLink = "green";

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

Par défaut
#0000FF

background	NN 6 IE 4 DOM 1
	Lecture/écriture
Fournit l´adresse URL de l'image d'arrière-plan de tout le document. 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.body.background = "images/watermark.jpg";

Valeur
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 l'élément. 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.body.bgColor = "yellow";

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

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

bgProperties	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Détermine si l'image d'arrière-plan reste fixe ou défile lorsque l'utilisateur fait défiler la page. Lorsque l'image d'arrière-plan est fixe, le contenu défile sur cette image pratiquement de la même manière qu´un générique de film défile sur un écran de cinéma ou de télévision.

Exemple

document.body.bgProperties = "fixed";

Valeur
Une chaîne vide (indiquant le comportement de défilement normal) ou la chaîne constante insensible à la casse fixed.

Par défaut
Une chaîne vide.

bottomMargin	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Indique la quantité d'espace blanc entre la fin du contenu et le bas d'une page pouvant défiler. Cet attribut ne produit aucun effet visuel si la longueur du contenu ou la taille de la fenêtre sont tels qu'il n'est pas nécessaire de faire défiler la page. Par défaut, la fin du contenu coïncide avec la fin du document. Cependant, dans la version Macintosh de Microsoft Internet Explorer, une marge d'environ 10 pixels est visible, même lorsque cette propriété est paramétrée sur zéro. Les valeurs supérieures à zéro sont appliquées correctement. Cette propriété représente en quelque sorte un raccourci ou une alternative pour définir la propriété de feuille de style marginBottom pour l'objet élément body.

Exemple

document.body.bottomMargin = 20;

Valeur
Nombre entier (supérieur ou égal à zéro) correspondant au nombre de pixels d'espace vide en bas du document.

Par défaut
0

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.

isTextEdit	NN s.o. IE 4 DOM s.o.
	Lecture seule
Spécifie si l´élément peut être utilisé pour créer un objet TextRange IE pour Windows (par le biais de la méthode createTextRange() ). Vous ne pouvez créer des plages de texte que pour le contenu des éléments body , button , input et textarea (type texte).

Exemple

if (document.getElementById("elementID").isTextEdit) { var rng = document.getElementById("elementID").createTextRange(); }

Valeur
Valeur booléenne: true \| false .

Par défaut
Valeur par défaut de l´élément.

noWrap	NN s.o. IE 4 DOM 1
	Lecture/écriture
Détermine si le navigateur doit élargir le contenu de manière à 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.body.noWrap = "true";

Valeur
Valeur booléenne: true \| false.

Par défaut
false

createTextRange()	NN s.o. IE 4 (Win) DOM s.o.

Crée un objet TextRange à partir du contenu texte affiché de l'élément courant. Reportez-vous à l'objet TextRange pour plus de détails.

Paramètres
Aucune.

Valeur renvoyée
Objet TextRange.

tabIndex	NN 6 IE 4 DOM 1
	Lecture/écriture
Nombre indiquant la position de cet élément dans l'ordre de tabulation des éléments pouvant être activés dans le document. L'ordre de tabulation suit un ensemble de règles très strictes. Les éléments dont les valeurs affectées aux propriétés tabIndex diffèrent de zéro sont les premiers activés lorsqu'un utilisateur commence à�tabuler dans une page. Le premier élément activé est celui dont l'attribut tabIndex a la valeur la plus faible, et ainsi de suite, dans l'ordre croissant, quel que soit l'emplacement physique des éléments sur la page ou dans le document. Si deux éléments ont un attribut tabIndex de valeur identique, c'est celui qui apparaît le premier dans le document qui est activé d'abord. Viennent ensuite les éléments qui ne prennent pas en charge la propriété tabIndex ou dont la valeur est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document.

Le DOM W3C et Netscape 6 limitent la propriété tabIndex aux objets éléments suivants: a , area , button , input , object , select , textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , span , table , et td . IE 5 ajoute tout autre élément affichable. Une valeur négative dans IE (uniquement) supprime un élément de la séquence de tabulation.

Les liens et les ancres ne sont pas activables à�l'aide de la touche de tabulation dans la version Macintosh de Microsoft Internet Explorer 4 et la propriété tabIndex des objets éléments a est donc ignorée dans cette version.

Exemple

document.getElementById("link3").tabIndex = 6;

Valeur
Nombre entier.

Par défaut
0

accessKey	NN s.o. IE 4 DOM 1
	Lecture/écriture
Une seule touche de caractère qui active un élément (dans certains navigateurs) ou active un contrôle de formulaire ou une action de lien. Le navigateur et le système d'exploitation déterminent si l'utilisateur doit appuyer sur une touche de modification (par exemple Ctrl, Alt ou Commande) en même temps que sur la touche d'accès pour activer le lien. Dans IE 5 pour Windows et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Alt et celle-ci est insensible à�la casse. Dans IE 5 pour Macintosh et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Ctrl.

Bien que répertorié ici comme attribut largement partagé, ce n'est pas toujours le cas dans toutes les implémentations. Netscape 6 (par le biais du DOM W3C) reconnaît cette propriété pour les éléments suivants uniquement: a , area , button , input , label , legend et textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , object , select , span , table et td (mais supprime label et legend ). IE 5 ajoute tout autre élément affichable, mais attention: à�l'exception de l'élément input et d'autres éléments ayant trait aux formulaires, vous devez aussi affecter un attribut tabindex ou une propriété tabIndex à�l'élément dans IE 5 et versions ultérieures (même s'il ne s'agit que d'une valeur de zéro pour tous) pour permettre à�la combinaison de touches d'accélération d'activer l'élément. A partir de Netscape 7, Netscape ne modifie pas le comportement de l'interface utilisateur si un script modifie la valeur de la propriété.

Exemple

document.links[3].accessKey = "n";

Valeur
Caractère unique du clavier alphanumérique (y compris les signes de ponctuation).

Par défaut
Une chaîne vide.

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

recordNumber	NN s.o. IE 4 DOM s.o.
	Lecture seule
Utilisée avec la fonction de liaison de données IE, renvoie un nombre entier représentant l'enregistrement dans le jeu de données ayant généré l'élément (par exemple un élément dont le contenu provient d'une liaison de données). Vous pouvez utiliser les valeurs de cette propriété pour extraire un enregistrement donné d'un ensemble d'enregistrements Active Data Objects (ADO) (voir la propriété recordset ). Bien que cette propriété soit définie pour tous les objets éléments de Microsoft Internet Explorer, les autres propriétés associées à�la liaison de données appartiennent à�un sous-ensemble d'éléments.

Exemple

<script for="tableTemplate" event="onclick"> myDataCollection.recordset.absoluteposition = this.recordNumber; ... </script>

Valeur
Nombre entier.

Par défaut
null

scrollHeight, scrollWidth	NN 7 IE 4 DOM s.o.
	Lecture seule
A l'origine, implémentées dans IE 4 pour les éléments qui défilaient ou influençaient le défilement d'un élément (body , button , caption , div , fieldset , legend , marquee et textarea ), ces propriétés renvoient les dimensions en pixels d'un élément, y compris les éléments plus grands que la zone visible de la fenêtre du navigateur. Elles sont donc différentes des propriétés clientHeight et clientWidth pour les éléments pouvant défiler, qui renvoient seulement les dimensions des portions visibles de l'élément. Cependant, IE pour Macintosh interprète différemment le but des propriétés de défilement et renvoie les dimensions de la portion visible.

A partir de Microsoft Internet Explorer 5 pour Windows, tous les éléments HTML ont ces propriétés et les valeurs pour les éléments ne défilant pas, sont les mêmes que celles des propriétés offsetHeight et offsetWidth . Netscape 7 implémente ces propriétés pour tous les éléments et renvoie la hauteur et la largeur de l'élément, visible ou non. Pour les éléments clés tels que body , il est important de retenir que ces propriétés peuvent être interprétées différemment et sont donc susceptibles de perturber l'opération sur différentes plates-formes.

Exemple

var midPoint = document.body.scrollHeight/2;

Valeur
Nombre entier positif ou zéro.

Par défaut
Aucune.

scrollLeft, scrollTop	NN 7 IE 4 DOM s.o.
	Lecture/écriture
Fournit la distance en pixels existant entre le côté gauche ou supérieur réel du contenu physique de l'élément et le côté gauche ou supérieur de la partie visible du contenu. Le paramétrage de ces propriétés permet d'utiliser un script pour ajuster le défilement du contenu à�l'intérieur d'un conteneur capable de défilement, tel que du texte dans un élément textarea ou un document entier dans une fenêtre ou un cadre de navigateur. Si personne ne fait défiler le contenu, les deux valeurs sont égales à�zéro. Si la valeur de la propriété scrollTop est �15, le document défile de 15 �pixels dans la fenêtre; la propriété scrollLeft n'est pas affectée, sauf si elle est modifiée. Les valeurs de ces propriétés changent au fur et à�mesure que l'utilisateur modifie la position des barres de défilement. Cela est important pour certaines tâches de positionnement basées sur les événements dans IE pour Windows, car le système de coordonnées pour les mesures de décalage d'événements est fonction de la zone visible d'une page dans la fenêtre du navigateur. Vous devez ajouter les facteurs de défilement document.body pour aligner les coordonnées d'événements avec les positions du contenu du corps (reportez-vous à�l'exemple de glissement d'un élément dans le chapitre 6). A partir de Microsoft Internet Explorer 5 pour Windows, les propriétés scrollLeft et scrollTop sont disponibles pour tous les objets éléments HTML, mais les valeurs pour les éléments qui ne défilent pas sont de zéro.

Exemple

document.body.scrollTop = 40;

Valeur
Nombre entier positif ou zéro.

Par défaut
0