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.

leftMargin | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Fournit la largeur en pixels de la marge gauche de l'élément body dans la fenêtre ou le cadre du navigateur. Par défaut, le navigateur insère une petite marge pour éviter que le contenu s'affiche contre le côté gauche de la fenêtre. Définir une chaîne vide pour cette propriété équivaut à la paramétrer sur zéro.
Exemple
    document.body.leftMargin = 16;
Valeur
Nombre entier de pixels.
Par défaut
10 (Windows); 8 (Macintosh).

link | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique la couleur d´un lien hypertexte non visité (dont l'adresse URL ne se trouve pas dans la mémoire cache du navigateur). Un lien peut avoir trois états: non activé, actif et déjà activé. 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. Cette propriété produit le même effet que la propriété linkColor de l'objet document.
Exemple
    document.body.link = "#00FF00";
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
#0000FF

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

rightMargin | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Fournit la largeur en pixels de la marge droite de l'élément body dans la fenêtre ou le cadre du navigateur. Par défaut, le navigateur insère une petite marge pour éviter que le contenu s'affiche contre le côté droit de la fenêtre (sauf sur Macintosh). Définir une chaîne vide pour cette propriété équivaut à la paramétrer sur zéro.
Exemple
    document.body.leftMargin = 16;
Valeur
Nombre entier de pixels.
Par défaut
10 (Windows); 0 (Macintosh).

scroll | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Détermine si la fenêtre (ou le cadre) affiche des barres de défilement lorsque le contenu dépasse la capacité d'affichage. Si votre document spécifie une définition DOCTYPE compatible avec les normes (reportez-vous au chapitre 8), la propriété scroll ne répond pas aux modifications pour l´élément body. L´objet élément html n´acquiert pas cette propriété non plus, comme le prétend la documentation Microsoft pour les développeurs.
Exemple
    document.body.scroll = "no";
Valeur
Pas tout à fait une valeur booléenne. Nécessite une des valeurs de chaîne suivantes: yes | no | auto.
Par défaut
yes

text | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique la couleur de texte pour tout le corps du document. Identique à la couleur de premier plan.
Exemple
    document.body.text = "darkred";
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
Valeur par défaut du navigateur (personnalisable par l'utilisateur).

topMargin | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Fournit la largeur en pixels de la marge supérieure de l'élément body dans la fenêtre ou le cadre du navigateur. Par défaut, le navigateur insère une petite marge pour éviter que le contenu s'affiche contre le côté supérieur de la fenêtre. Définir une chaîne vide pour cette propriété équivaut à la paramétrer sur zéro.
Exemple
    document.body.topMargin = 16;
Valeur
Nombre entier de pixels.
Par défaut
15 (Windows); 8 (Macintosh).

vLink | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique la couleur d'un lien hypertexte visité récemment. 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 aLink pour plus de détails 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é vlinkColor de l´objet document.
Exemple
    document.body.vLink = "gold";
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
#551a8b (Navigator 4); #800080 (Internet Explorer 4 pour Windows); #006010 (Internet Explorer 4 pour Macintosh).

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