L'objet document représente tout le contenu du document, c´est-à-dire aussi bien le contenu affiché dans la fenêtre ou le cadre du navigateur que tout autre contenu du fichier HTML chargé dans la fenêtre ou le cadre. Toutes les informations de la section head du fichier font donc également partie de l'objet document. Toutes les références aux éléments doivent comprendre une référence à l'objet document. Le nom de l'objet document est identique à celui de son nom « en dur »: document.

Référence à l'objet actuellement désigné comme l´élément actif dans le document. Pour en savoir plus sur l'objet renvoyé, examinez ses propriétés tagName, id ou autres. Les boutons et autres éléments n'étant pas activés sur IE 4 pour Mac, la valeur renvoyée pour cette propriété peut varier en fonction du système d'exploitation. Alors qu´un élément (surtout un contrôle de formulaire) qui reçoit l´activation devient actif, il est possible qu´un élément soit actif, mais que du fait d´autres paramètres dans les versions de Microsoft Internet Explorer les plus récentes, il ne reçoive pas l´activation. Reportez-vous à la méthode setActive() partagée.

Indique la 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 linkColor et vLinkColor pour plus d'informations sur la couleur des liens activés et non activés. Remplacée dans le DOM W3C par la propriété aLink de l´objet body, qui est pris en charge par IE 4 et les versions ultérieures, ainsi que par Netscape 6. Les valeurs modifiées dynamiquement pour alinkColor ne sont pas reflétées sur la page dans Navigator jusqu´à la version 4.

Renvoie un tableau de tous les objets anchor du document courant, c´est-à-dire les éléments a utilisés comme ancres ou comme combinaisons d'ancres et de liens. Les éléments de ce tableau sont indexés (en base zéro) dans l'ordre dans lequel ils apparaissent dans le code source.

Renvoie un tableau de tous les objets applet Java du document courant. Une applet doit être lancée et active pour être considérée comme objet existant. Les éléments de ce tableau sont indexés en base zéro dans l'ordre dans lequel ils apparaissent dans le code source.

Définit la couleur d'arrière-plan du document. 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.

Renvoie une référence à l'objet body défini par l'élément body dans le document. Cette propriété est utilisée comme passerelle vers les propriétés de l'objet body.

Indique l´encodage de caractère du contenu du document. Dans IE 6 pour Windows, cette propriété a été remplacée par la propriété document.defaultCharset. Pour Netscape 6, utilisez la propriété document.characterSet.

Indique l´encodage de caractère du contenu du document.

Renvoie le mode de compatibilité pour le document, tel qu´il est contrôlé par le contenu de l´élément DOCTYPE. Consultez la section consacrée à l´élément DOCTYPE dans le chapitre 8 pour des détails sur la façon de forcer le navigateur à traiter un document en mode de compatibilité ascendante ou de compatibilité avec les normes pour le placement des éléments et autres détails d´implémentation. Comme le choix du mode peut affecter certains résultats de propriétés de style, vous pouvez utiliser cette propriété pour exécuter un branchement entre deux calculs dans une bibliothèque partagée de façon à ce qu´ils traitent le document courant correctement, quel que soit le mode.

Indique le cookie HTTP associé au domaine du document et stocké sur la machine client. Les navigateurs Netscape regroupent toutes les données de cookies dans un seul fichier, alors qu´IE crée un fichier indépendant pour les données de cookies de chaque domaine. La lecture et l'écriture de la propriété cookie ne s'effectuent pas en parallèle. La lecture d'une propriété cookie renvoie une liste de paires nom / valeur séparées par des points-virgules, au format suivant:

Indique l´encodage de caractères du contenu du document.

Renvoie une référence à la représentation abstraite DOM W3C d´un « visualiseur » qui affiche le document (le nom de l´objet est AbstractView). Dans Netscape 6, cet objet correspond à l´objet window ou frame qui contient le document. Une fonction de script ayant accès à un objet document (par exemple via la propriété ownerDocument d´un objet élément) peut obtenir une référence valide à la fenêtre du document avec cette propriété defaultView. L´affichage du document comprend la connaissance des règles de style en cascade appliquées à chaque élément. Reportez-vous au chapitre 4 pour voir un exemple de la façon d´obtenir le style d´un élément avec la propriété document.defaultView et la méthode getComputedStyle().

Renvoie une référence à l´objet élément DOCTYPE (le même que l´objet de noeud DocumentType de la représentation abstraire du DOM W3C). La propriété ne renvoie une valeur de référence que si DOCTYPE est spécifié dans le document; sinon, la propriété renvoie la valeur null. Dans la version 6, IE pour Windows n´implémente pas cette propriété ou ce type de noeud. Voir l'objet DocumentType pour consulter les propriétés disponibles dans les divers navigateurs. Dans un environnement DOM W3C pur, la propriété doctype est héritée de l´objet document principal et est donc aussi disponible pour les documents XML.

Renvoie une référence au noeud élément racine du document. Pour les documents HTML, la référence est pour l´élément html qui comprend les éléments head et body du document. Dans un environnement DOM W3C pur, la propriété documentElement est héritée de l´objet document principal et est donc aussi disponible pour les documents XML.

Fournit le nom d'hôte du serveur qui a remis le document. Si plusieurs documents provenant de différents serveurs d'un même domaine doivent échanger du contenu, les propriétés domain des deux documents doivent être paramétrées sur le même domaine afin d'éviter des restrictions de sécurité. En principe, si les hôtes ne correspondent pas, la sécurité du navigateur empêche l'accès aux données formulaire de l'autre document. Par exemple, cette propriété permet à une page du serveur www de communiquer avec une page d'un serveur sécurisé.

Renvoie un tableau de tous les objets incorporés (éléments embed) du document courant. Les éléments de ce tableau sont indexés en base zéro dans l'ordre dans lequel ils apparaissent dans le code source.

Détermine si les scripts du document courant permettent de créer et d´utiliser des propriétés personnalisées, affectées à l'objet document. La nature extensible de JavaScript permet aux auteurs de script de créer une nouvelle propriété d'objet simplement en lui affectant une valeur (comme dans document.stooge = "Curly"). Cela signifie également que le document accepte des instructions de propriétés incorrectement écrites, par exemple lorsqu'une lettre au milieu d'un nom de propriété long n'est pas en majuscule (marginLeftColor). De telles instructions sont acceptées telles quelles, mais le résultat escompté n'est visible nulle part. Si vous n'avez pas l'intention de créer des propriétés personnalisables, affectez la valeur false à document.expando dans une instruction de script d'ouverture lorsque vous écrivez une page. Cette procédure contribue à éviter la génération de bogues en cas d'erreurs de frappe. Ce paramétrage affecte uniquement les scripts du document courant.

Fournit la couleur du texte de premier plan du document. Bien que vous puissiez modifier cette propriété dans toutes les versions de Navigator, le texte ne change pas dynamiquement dans les versions antérieures à la version 6. Cette propriété est toujours prise en charge dans les navigateurs actuels et est remplacée par document.body.text ou les paramètres de feuille de style dans IE 4 et Netscape 6.

Renvoie une chaîne de la date (mais pas de l´heure) à laquelle le serveur (ou système de fichiers local) indique que le fichier actuellement chargé a été créé. Dans IE 4, la valeur est au format de date longue, mais à partir de IE 5, les informations de date sont formatées comme suit: mm/jj/aaaa. La valeur risque d´être corrompue si le serveur transmet les données dans un format auquel IE ne s´attend pas. Non implémentée dans Internet Explorer pour Macintosh jusqu´à la version 5.1.

Renvoie une chaîne de la date (mais pas de l´heure) à laquelle le serveur (ou système de fichiers local) indique que le fichier actuellement chargé a été modifié pour la dernière fois. Dans IE 4, la valeur est au format de date longue, mais à partir de IE 5, les informations de date sont formatées comme suit: mm/jj/aaaa. La valeur risque d´être corrompue ou incorrecte si le serveur transmet les données dans un format auquel IE ne s´attend pas. Non implémentée dans Internet Explorer pour Macintosh jusqu´à la version 5.1.

Renvoie le nombre d´octets pour la taille du document actuellement chargé. IE pour Windows renvoie cette valeur sous la forme d´une chaîne, alors qu´IE pour Mac la renvoie sous la forme d´une valeur numérique (une distinction importante si vous avez besoin d´effectuer des opérations mathématiques sur cette valeur).

Renvoie une chaîne vide. Apparemment pas de prise en charge officielle pour l´objet document.

Renvoie un tableau de tous les objets form (éléments form) du document courant. Les éléments de ce tableau sont indexés (en base zéro) dans l´ordre du code source, mais il est aussi possible d´y accéder en utilisant le nom du formulaire comme valeur d´index sous forme de chaîne.

Renvoie un tableau de tous les objets iframe (objets éléments iframe, à ne pas confondre avec les objets frame de style fenêtre) du document courant. Les éléments de ce tableau sont indexés en base zéro dans l'ordre dans lequel ils apparaissent dans le code source. Pour des raisons de compatibilité avec les navigateurs IE 5 et versions ultérieures, ainsi que Netscape 6, utilisez plutôt document.getElementsByTagName("iframe").

Renvoie les dimensions en pixels de la totalité du document affiché. Ces valeurs correspondent aux valeurs des propriétés offsetHeight et offsetWidth pour l´objet document.body. Du fait les paires de ces propriétés ne sont pas approuvées par le DOM W3C, il est préférable de choisir la paire de décalage, car elle est compatible avec les différents navigateurs.

Utilisée avec la syntaxe de feuilles de style JavaScript Navigator 4 uniquement, la collection ids[] fait partie d'une référence à un seul ID et la propriété de style qui lui est affectée dans la syntaxe [document.]ids.idName.stylePropertyName. Pour la liste des propriétés connexes, voir la liste d'objets tags dans ce chapitre.

Renvoie un tableau de tous les objets éléments img (à l´exception des images précachées chargées avec le constructeur new Image()) du document courant. Les éléments de ce tableau sont indexés (en base zéro) selon l'ordre du code source et vous pouvez y accéder par numéro ou par nom de chaîne. La présence de cette propriété indique la prise en charge des images permutables en temps réel.

Renvoie une référence à l´objet DOMImplementation W3C, qui représente, d´une façon limitée, l´environnement composant le conteneur du document, dans notre cas, le navigateur. Les méthodes de l´objet vous permettent de voir quels modules DOM le navigateur dit prendre en charge. Cet objet est aussi une passerelle permettant la création d´objets Document et DocumentType W3C virtuels hors de l´arborescence de documents actuelle. Ainsi, dans Netscape 6, vous pouvez utiliser la propriété document.implementation pour commencer à générer un document non affiché pour les documents XML externes. Reportez-vous à l´objet DOMImplementation pour des détails au sujet des méthodes et leur prise en charge par les navigateurs.

Fournit la date et l´heure (sous forme de chaîne) de la dernière modification du fichier du document, selon le serveur. Certains serveurs ne fournissent pas ou pas correctement cette information. Les navigateurs autres que les navigateurs pour Windows ont souvent du mal à interpréter ces informations correctement. Ce n´est que dans les navigateurs récents que la chaîne de date se trouve sous une forme de paramètre adaptée à un constructeur d´objets Date.

Renvoie pour Navigator 4 uniquement un tableau de tous les objets éléments layer contenus dans le document courant. Dans le tableau, sont aussi incluses des références à d´autres éléments HTML avec des feuilles de style qui définissent l´élément comme étant à positionnement relatif ou absolu (auquel cas, Navigator 4 traite ces éléments comme des objets de calque). Les éléments de ce tableau sont indexés (en base zéro) dans l'ordre dans lequel du code source et vous pouvez y accéder par numéro ou par nom de chaîne. En tant que fonctionnalité implémentée dans Navigator 4 uniquement, la présence de cette propriété indique la prise en charge des conditions requises des références uniques pour les calques Netscape.

Indique la couleur des liens hypertexte non visités (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. Les modifications de cette propriété ne modifient pas la couleur du lien de façon dynamique dans Navigator 4 ou les versions antérieures. A partir de Microsoft Internet Explorer 4 et Netscape 6, utilisez l´alternative du DOM W3C, document.body.link, ou les feuilles de style.

Indique l´adresse URL du document courant. Cette propriété a été délaissée car elle peut entrer en conflit avec la propriété window.location. Netscape 6 ne prend plus cette propriété en charge du tout. Utilisez la propriété document.URL ou, mieux encore, la propriété window.location.href.

Renvoie une chaîne indiquant le support de sortie pour lequel le contenu est formaté. A partir de Microsoft Internet Explorer 6, la propriété renvoie une chaîne vide et génère une erreur de sécurité si vous affectez des valeurs de chaînes acceptées (all, print ou screen). Evitez d´utiliser cette propriété avec l´objet document.

Renvoie une chaîne indiquant le type de document de base, mais pas au format MIME. Pour un document HTML, à partir de Microsoft Internet Explorer 5.5, la chaîne renvoyée est HTML Document. Ne confondez pas cette propriété de l´objet document avec la propriété navigator.mimeTypes de Netscape et IE pour Mac, qui est totalement différente.

Renvoie une chaîne contenant les mêmes données que document.title, y compris une chaîne vide s´il n´y a pas d´élément title dans le document. Il est possible que cette propriété ne soit pas prise en charge pour l´objet document.

Renvoie un tableau de tous les objets namespace IE implémentés dans le document courant. Un objet namespace est une passerelle permettant le chargement de comportements externes. Pour plus de détails, visitez http://msdn.microsoft.com/workshop/author/behaviors/overview/elementb_ovw.asp.

Renvoie une référence à l'objet window (qui peut être un cadre dans un jeu de cadres) contenant le document courant. Utilisez cette référence pour accéder directement aux propriétés et méthodes de la fenêtre. La valeur renvoyée est identique à la référence window du document.

Renvoie un tableau de tous les objets incorporés (éléments embed) du document courant. Les éléments de ce tableau sont indexés en base zéro dans l'ordre dans lequel ils apparaissent dans le code source. Ne confondez pas cette collection avec la collection navigator.plugins de Netscape Navigator.

Renvoie une chaîne en anglais décrivant le protocole utilisé pour charger le document courant. Contrairement à la valeur littérale de la propriété location.protocol (par exemple http: ou file:), document.protocol est compréhensible (par exemple Hypertext Transfer Protocol ou File Protocol).

Renvoie l'état de téléchargement courant du contenu du document. Si un script (en particulier un script déclenché par un événement utilisateur) peut exécuter certaines actions lors du chargement du document, mais doit en éviter d'autres tant que la page n'est pas complètement chargée, cette propriété fournit des informations intermédiaires sur le processus de chargement. Utilisez sa valeur dans des tests de condition. La valeur de cette propriété change de façon dynamique en fonction du progrès du chargement. Toute modification de la valeur de propriété déclenche un événement onreadystatechange.

Renvoie une chaîne de l'adresse URL de la page à partir de laquelle la page courante a été appelée, à condition que la page d'origine propose un lien vers la page courante. De nombreux journaux de serveurs capturent également cette information. Les scripts peuvent déterminer l'endroit à partir duquel le visiteur a accédé au document, et éventuellement adapter le contenu de la page en conséquence. Si le visiteur a accédé à la page par un autre moyen, par exemple en tapant l'adresse URL du document dans une boîte de dialogue de son navigateur ou en sélectionnant un signet, la propriété referrer renvoie une chaîne vide. De nombreuses versions de Microsoft Internet Explorer pour Windows ne rapportent pas correctement l´URL de referrer et affichent souvent à la place l´URL de la page courante.

Renvoie un tableau de tous les objets script (éléments script) du document courant. Chaque objet script peut comprendre un nombre quelconque de fonctions. La collection scripts[] compte le nombre de balises <script> réelles dans le document. Les éléments de ce tableau sont indexés en base zéro dans l'ordre dans lequel ils apparaissent dans le code source.

Renvoie une chaîne décrivant la politique de sécurité mise en oeuvre pour le document courant.

Renvoie un objet selection. Pour pouvoir utiliser le texte sélectionné par l'utilisateur ou par un script, vous devez convertir la sélection en un objet TextRange. Ce n'est possible que dans Internet Explorer pour Win32. L´accès à la sélection Netscape 6 se fait par le biais de la propriété window.selection.

Renvoie un tableau de tous les objets styleSheet du document courant. Chaque objet style peut contenir un nombre quelconque de règles de feuille de style. La collection styleSheets[] compte le nombre de balises <style> réelles dans le document, ainsi que les balises <link> qui chargent les fichiers de feuilles de style externes. Les éléments de ce tableau sont indexés (en base zéro) dans l'ordre dans lequel ils apparaissent dans le code source. L´objet de feuille de style @import est accessible par le biais de la propriété cssRule.styleSheet d´un objet styleSheet. Voir l'objet styleSheet.

Utilisée avec la syntaxe de feuilles de style JavaScript pour Navigator 4 seulement, la collection tags[] fait partie d'une référence à un seul type de balise et à la propriété de style qui lui est affectée. Pour la liste des propriétés, voir la liste d'objets tags dans ce chapitre. Ne confondez pas cette utilisation de la collection tags[] par Navigator avec l'utilisation, par Internet Explorer, de la collection tags[] qui appartient à la collection all.

Contrairement à la propriété title des objets qui représentent des éléments HTML, la propriété document.title fait référence au contenu de l'élément title défini dans la section head d'un document. Pour faciliter l'identification du document, ce titre s'inscrit dans la barre de titre du navigateur. C'est également ce contenu qui indique la page dans une liste de signets. Bien que la propriété soit en lecture/écriture, ne soyez pas surpris si une version de navigateur ne modifie pas la barre de titre de la fenêtre en réponse.

Indique l´adresse URL du document courant. La valeur est identique à location.href. La propriété document.URL est devenue un remplacement de la propriété document.location afin d'éviter toute confusion possible (des scripteurs et des moteurs qui interprètent JavaScript) entre l'objet location et la propriété document.location. Pour vous diriger vers une autre page, il est plus prudent (pour préserver la compatibilité ascendante et celle entre navigateurs) d'affecter une valeur de chaîne d'adresse URL à la propriété location.href, plutôt que d'utiliser cette propriété, qui concerne le document actuel et non la fenêtre.

Renvoie l´URL du document courant, mais tous les caractères codés URL sont convertis à leur version en anglais (par exemple %20 est converti en caractère d´espacement). La valeur renvoyée est la même que si vous appliquiez la fonction decodeURI() JavaScript à document.URL.

Couleur d'un lien hypertexte activé 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 alinkColor et linkColor pour plus d'informations sur la couleur des liens activés et non activés. Les modifications de cette propriété ne modifient pas la couleur du lien de façon dynamique dans Navigator 4 ou les versions antérieures. A partir de Microsoft Internet Explorer 4 et Netscape 6, utilisez l´alternative du DOM W3C, document.body.vlink, ou les feuilles de style.

Voir height.

Cette série de méthodes objets document Netscape 6 fait partie d´une fonctionnalité de programmation de navigateur appelée Extensible Binding Language (XBL), un ajout au mécanisme basé sur XML que le navigateur utilise pour générer les apparences de l´interface utilisateur. Pour en savoir plus sur XBL, visitez http://www.mozilla.org/docs/xul/xulnotes/xulnote_xbl.html.

Indique au navigateur d'intercepter des événements d'un type spécifique avant qu'ils n'atteignent leurs objets cibles. Pour traiter l'événement, l'objet appelant cette méthode doit alors disposer de gestionnaires d'événements définis pour ce type d'événement. Bien que cette méthode fasse partie du modèle d´événement Navigator 4, elle est encore prise en charge dans Netscape 6; elle y crée l´équivalent d´un auditeur d´événements en mode capture DOM W3C pour l´objet document. Continuez d´utiliser cette méthode si vous devez prendre Navigator 4 en charge, mais utilisez la syntaxe d´auditeur d´événements DOM W3C pour le nouveau code, comme l´explique le chapitre 6.

Supprime le document courant de la fenêtre ou du cadre, généralement dans la perspective d'ouvrir un nouveau flux et d´écrire un nouveau contenu. Les méthodes document.write() et document.writeln() invoquent automatiquement cette méthode. La méthode document.clear() contenait de nombreuses bogues dans les premières versions des navigateurs. Aujourd'hui encore, il est conseillé de confier cette t che aux méthodes d'écriture dans un document. Le DOM W3C omet explicitement cette méthode.

Ferme le flux d'écriture du document dans une fenêtre ou un cadre. Si un script utilise une des méthodes document.write() ou document.writeln() pour générer un nouveau contenu pour une fenêtre ou un cadre, vous devez ensuite utiliser la méthode document.close() pour être certain que tout le contenu sera écrit dans le document. Faute d'utiliser cette méthode, il se peut qu'une partie du contenu ne soit pas écrite. Cette méthode prépare également la fenêtre ou le cadre à un tout nouvel ensemble de contenu à l´aide de la méthode suivante d'écriture dans le document. Toutefois, n´utilisez pas la méthode document.close() si vous utilisez les méthodes d'écriture dans le document pour remplir de façon dynamique une page en cours de chargement.

Génère, dans la mémoire, une instance du noeud d´attribut (objet Attr). Une séquence typique est de créer l´attribut, de lui affecter une valeur avec sa propriété nodeValue, puis d´insérer le noeud Attr dans la liste d´attributs d´un élément avec la méthode setAttributeNode() de l´élément.

Génère, dans la mémoire, une instance du noeud d´attribut (objet Attr) dont le nom est défini dans un espace de nom externe. Une séquence typique est de créer l´attribut, de lui affecter une valeur avec sa propriété nodeValue, puis d´insérer le noeud Attr dans la liste d´attributs d´un élément avec la méthode setAttributeNodeNS() de l´élément.

Génère, dans la mémoire, une instance du noeud de section de données de caractères (objet CDATASection) dans un document XML (y compris XHTML). Implémentée, mais partiellement seulement, à partir de Netscape 7.

Génère, dans la mémoire, une instance du noeud de commentaire (objet Comment avec une valeur nodeValue de 8). Une séquence typique est de créer le noeud Comment, puis de l´insérer à l´emplacement désiré de l´arborescence de documents avec la méthode appendChild() ou insertBefore() de n´importe quel noeud. Implémentée, mais partiellement seulement, dans IE 5 pour Mac.

Génère, dans la mémoire, une instance du noeud de fragment de document vide (objet DocumentFragment). Ce noeud devient un conteneur arbitraire pour assembler une séquence de noeuds qui finissent par être ajoutés ou insérés dans une arborescence de documents. Reportez-vous à l'objet DocumentFragment pour plus de détails.

Génère en mémoire une instance d'un objet élément associé à la balise transmise en paramètre à la méthode. Cette méthode est limitée aux éléments area, img et option dans IE 4; tous les éléments sont permis dans les autres navigateurs prenant la méthode en charge. Aucune valeur d´attribut (à l´exception de toute valeur affectée selon la DTD) n´est affectée à un nouvel élément et cet élément nouvellement créé ne fait pas encore partie de l´arborescence de documents. Affectez des attributs (tels que type pour un élément input ou id pour n´importe quel élément) et ajoutez ou insérez l´élément à l´arborescence de documents. Cette séquence est l´approche du DOM W3C pour générer un nouveau contenu (à la place des propriétés innerHTML implémentées dans les navigateurs IE et Netscape 6).

Génère en mémoire une instance d'un objet élément associé à un espace de nom et à la balise transmise comme une partie des paramètres de la méthode. Aucune valeur d´attribut (à l´exception de toute valeur affectée selon la DTD) n´est affectée à un nouvel élément et cet élément nouvellement créé ne fait pas encore partie de l´arborescence de documents. Affectez des attributs (tels que type pour un élément input ou id pour n´importe quel élément) et ajoutez ou insérez l´élément à l´arborescence de documents.

Génère, dans la mémoire, une instance de l´objet noeud de référence d´entité dans un document XML. Prise en charge partielle seulement dans IE 5 pour Mac et Netscape à partir de la version 7.

Génère, dans la mémoire, une instance d´un objet Event du DOM W3C d´une catégorie d´événements particulière. Après la création de l´événement générique, il doit être initialisé (avec l´une des diverses méthodes d´initialisation) en tant que type d´événement particulier, avec d´autres propriétés appropriées pour la catégorie d´événements. La séquence suivante crée un événement mousedown et l´envoie à un élément:

Génère, dans la mémoire, une instance d´objet event de DOM IE vide. Une fois l´événement générique créé, ses propriétés peuvent recevoir des valeurs appropriées pour aider au traitement de l´événement. Ensuite, l´élément se comporte comme un paramètre de la méthode fireEvent() d´un événement, moment auquel le type d´événement est associé à l´événement. La séquence suivante crée un événement mousedown et l´envoie à un élément:

Génère, dans la mémoire, une instance d´un objet NodeIterator. Cette méthode a le même ensemble de paramètres que la méthode createTreeWalker(), qui est implémentée dans Netscape 7.

Génère, dans la mémoire, une instance de l´objet noeud d´instruction de traitement dans un document XML. Prise en charge partielle seulement dans IE 5 pour Mac et Netscape à partir de la version 7.

Crée un objet Range vide, dont les points de début et de fin sont fusionnés au point avant le premier caractère du texte du corps affiché. La méthode renvoie une référence à cet objet Range, que vous utilisez ensuite pour ajuster ses points de début et de fin, invoquer ses méthodes, etc. Reportez-vous à l'objet Range pour plus de détails au sujet de ses fonctionnalités de langage.

Cette méthode effectue les mêmes opérations dans IE Windows et pour Mac, mais les valeurs renvoyées sont différentes. De plus, les actions spécifiques dans l´arborescence de documents dépendent des paramètres transmis avec la méthode. Lorsqu´aucun paramètre n´est inclus, la méthode insère un élément style vide dans l´arborescence de documents. Cependant, cet élément style n´est pas reflété dans la collection document.styleSheets avant que vous n´ajoutiez une ou plusieurs règles de style à l´objet. Mais si vous spécifiez une URL vers un fichier .css externe comme premier paramètre, la méthode crée et insère un élément link dans la section d´en-tête du document, donnant ainsi vie aux règles de style externes immédiatement.

Génère, dans la mémoire, une instance d´un objet texte (objet Text du DOM W3C) dont la valeur nodeValue est le contenu du texte sans balises transmis comme paramètre. Un nouveau noeud de texte ne fait pas encore partie de l´arborescence de documents. Ajoutez on insérez le noeud dans l´arborescence de documents ou le fragment de document en train d´être assemblé pour une insertion ultérieure dans le document. Cette séquence est l´approche du DOM W3C pour générer un nouveau contenu (à la place de la propriété innerText implémentée dans les navigateurs IE).

Génère, dans la mémoire, une instance d´un objet TreeWalker.

Renvoie une référence à l'objet qui se situe sous les coordonnées en pixels spécifiées par les paramètres x (horizontale) et y (verticale). Pour être reconnu, l'élément doit pouvoir réagir aux actions de la souris. De plus, si plusieurs éléments sont placés au même endroit, l'élément renvoyé est celui qui possède la valeur zIndex la plus élevée ou, à valeurs zIndex égales, celui qui apparaît en dernier dans le code source.

Uniquement disponible dans Internet Explorer pour les plates-formes Win32, la méthode execCommand() exécute la commande nommée. La plupart des commandes nécessitent la création préalable d'un objet TextRange pour disposer d'un point d'insertion. Reportez-vous à l´annexe D pour une liste de commandes.

Voir addBinding()

Voir addBinding()

Voir addBinding()

Renvoie une référence au noeud de l´élément à partir de l´arborescence de documents dont la valeur de l´attribut id correspond à la valeur de paramètre. En l'absence de correspondance, la méthode renvoie null. Cette méthode, bien que contraignante à taper en respectant son nom sensible à la casse, est la passerelle de communication avec les objets éléments pour les scripts des navigateurs capables de traiter le DOM W3C.

Renvoie un tableau de références à tous les noeuds d´élément à partir de l´arborescence de documents dont la valeur de l´attribut name correspond à la valeur de paramètre. En l'absence de correspondance, la méthode renvoie null. Lorsqu´un élément prend en charge les attributs name et id, IE pour Windows inclut un élément dans le tableau renvoyé même si seul l´attribut id est défini sur la valeur du paramètre. IE pour Macintosh et Netscape 6 ne trouvent de correspondances que pour les éléments dont les attributs name sont explicitement définis sur la valeur du paramètre.

Dans Navigator 4, cette méthode capture le texte actuellement sélectionné dans le document. Cette méthode est délaissée dans Netscape 6 au profit de la méthode window.getSelection() (qui renvoie un objet selection élaboré, au lieu de simplement retourner du texte). L´appel à partir de l´objet document affiche un avertissement dans la fenêtre JavaScript Console, mais ne renvoie pas une exception à part entière. L´équivalent IE lit la propriété selection.

Indique à l'objet document qu´il doit accepter et traiter l'événement propre à Navigator 4 seulement dont les spécifications sont transmises à la méthode sous forme de paramètre. Pour pouvoir traiter l'événement, l'objet doit disposer d'un gestionnaire d'événements pour ce type d'événement.

Renvoie la valeur booléenne true si le document ou n´importe quel élément du document est activé. Un processus d´arrière-plan, tel qu´une fonction appelée par setTimeout(), peut découvrir si la fenêtre du document est actuellement la fenêtre au premier plan du bureau.

Importe un objet noeud à partir d´un autre document chargé dans le document courant, mais pas encore dans l´arborescence de documents. A bien des égards, importNode() fonctionne comme cloneNode(), mais elle suppose que le noeud source peut exister dans un contexte d´arborescence de documents entièrement différent (surtout dans un document XML). Les règles du DOM W3C pour cette méthode déterminent quels attributs et propriétés du noeud source font le « voyage » et ce qui leur arrive à l´arrivée. Par exemple, un noeud Attr perd son ownerElement (c´est-à-dire sa valeur devient null) lors de l´importation à partir d´un élément d´un document dans un état fragmenté dans le nouveau document, jusqu´à ce que l´attribut soit ajouté à un élément dans le nouveau document. Les noeuds de types Document et DocumentType ne sont pas importables.

Voir addBinding()

Ouvre le flux de sortie pour écrire dans la fenêtre ou le cadre courants. Si la méthode document.clear() n'a pas encore été invoquée, elle est automatiquement invoquée en réponse à la méthode document.open(). En raison des bogues présentes dans les premières versions, il est préférable d´utiliser les méthodes document.write() et document.writeln() pour appliquer cette méthode plus efficacement.

Détermine si la commande peut être invoquée en fonction de l'état actuel du document ou de la sélection. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Détermine si la commande est dans un état indéterminé. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Détermine l'état courant de la commande indiquée. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Détermine si la commande nommée est prise en charge par l'objet document. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Renvoie le texte associé à la commande. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Renvoie la valeur associée à la commande, tel le nom de police de la sélection. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.

Force le recalcul des expressions affectées à des attributs d´éléments avec la méthode setExpression(). Nécessaire uniquement quand le recalcul automatique n´est pas déclenché par une action de l´utilisateur, mais il est possible que les valeurs affectées aient changé.

Cette méthode est l´inverse de document.captureEvents(): elle désactive la capture d'événement au niveau du document pour un ou plusieurs événements spécifiques, passés en paramètres. Dans Netscape 6, elle effectue la même action que la méthode removeEventListener() du DOM W3C sur l´objet document. Reportez-vous au chapitre 6.

Voir addBinding()

Utilisée dans une fonction de gestionnaire d'événements, cette méthode indique à Navigator 4 de transmettre l'événement à son objet cible. Cette méthode ne cause pas d´erreur dans Netscape 6, mais elle n´effectue aucune action.

Si ces méthodes sont appelées lors du chargement de la page, elles permettent d´ajouter du contenu à la page de façon dynamique. Après le chargement de la page, un appel de ces méthode supprime le document courant, ouvre un nouveau flux de sortie et écrit le contenu dans la fenêtre ou le cadre. Un appel de la méthode document.close() est ensuite nécessaire. Comme la première méthode document.write() ou document.writeln() détruit le document courant, n'utilisez pas plus d'une instruction d'écriture pour créer un nouveau document. Chargez plutôt le contenu dans une variable que vous passerez en paramètre à une seule méthode document.write() ou document.writeln().