_document | NN 2 IE 3 DOM 1
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.
Pour un navigateur dont l´architecture interne est basée sur le DOM W3C, cet objet document représente l´objet HTMLDocument: un type spécial (sous-classe interne) de l´objet Document du module principal, fait pour contenir des documents HTML. En d´autres termes, l´objet HTMLDocument hérite des propriétés et des méthodes de l´objet Document principal (partageant les fonctions avec les documents XML) et a aussi des propriétés et des méthodes qui ne s´appliquent qu´aux documents HTML. Bien sr, il y a une incongruité conceptuelle: un HTMLDocument est-il applicable à un document XHTML puiqu´un tel document est, en théorie, un document XML. Mais, sur le plan pratique, même un document XML devient un document HTML à des fins de définition par script, et bénéficie donc de toutes les propriétés et méthodes HTMLDocument.
Un autre côté pratique important d´une implémentation DOM W3C (comme le montre l´implémentation Netscape 6) est que l´objet document implémente de façon interne des propriétés et méthodes de niveau document à partir d´autres modules du DOM, tels que les affichages, les événements et les styles. Chacun de ces modules définit un objet (DocumentEvent, DocumentRange, DocumentStyle et DocumentView) qui fournit une connexion essentielle entre le HTMLDocument et ces fonctionnalités de modules supplémentaires. Ainsi, c´est la propriété styleSheets de l´objet DocumentStyle dans le DOM W3C que l´objet document définissable par script décrit ici utilise pour accéder aux objets styleSheet et leurs règles. Et l´objet DocumentEvent crée un lien dans sa méthode createEvent() qui permet à l´objet document définissable par script de générer un événement autre que les événements créés par l´utilisateur ou le système normaux. Toutes ces fonctionnalités deviennent subsumées par l´objet document que vous référencez et définissez par script dans Netscape 6 et autres navigateurs similaires. Le module source précis pour une fonctionnalité particulière n´a pas d´importance; il vous suffit de savoir que les propriétés et méthodes appartiennent à l´objet document définissable par script.
Référence de modèle d'objet
    [window.]document
Propriétés spécifiques à l´objet
activeElement | alinkColor | anchors[] | applets[]
bgColor | body | charset | characterSet
compatMode | cookie | defaultCharset | defaultView
doctype | documentElement | domaine | embeds[]
expando | fgColor | fileCreatedDate | fileModifiedDate
fileSize | fileUpdatedDate | forms[] | frames[]
height | ids[] | images[] | implementation
lastModified | layers[] | linkColor | links[]
location | media | mimeType | nameProp
namespaces[] | parentWindow | plugins[] | protocol
readyState | referrer | scripts[] | security
selection | styleSheets[] | tags[] | title
URL | URLUnencoded | vlinkColor | width
Méthodes spécifiques à l´objet
addBinding() | captureEvents()
clear() | close()
createAttribute() | createAttributeNS()
createCDATASection() | createComment()
createDocumentFragment() | createElement()
createElementNS() | createEntityReference()
createEvent() | createEventObject()
createNodeIterator() | createProcessingInstruction()
createRange() | createStyleSheet()
createTextNode() | createTreeWalker()
elementFromPoint() | execCommand()
getAnonymousElementByAttribute() | getAnonymousNodes()
getBindingParent() | getElementById()
getElementsByName() | getSelection()
handleEvent() | hasFocus()
importNode() | loadBindingDocument()
open() | queryCommandEnabled()
queryCommandIndeterm() | queryCommandState()
queryCommandSupported() | queryCommandText()
queryCommandValue() | recalc()
releaseEvents() | removeBinding()
routeEvent() | write()
writeln() |
Propriétés de gestionnaire d´événements spécifiques à l´objet
Gestionnaire | NN | IE | DOM
onselectionchange | s.o | 4 | s.o
onstop | s.o | 4 | s.o

activeElement | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var currObj = document.activeElement;
Valeur
Référence de l'objet élément.
Par défaut
Aucune.

alinkColor | NN 2 IE 3 DOM s.o.
| Lecture/écriture (Internet Explorer)
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.
Exemple
    document.alinkColor = "green";
Valeur
Triplet de noms de couleurs en hexadécimal ou nom de couleurs en anglais. Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.
Par défaut
#0000FF

anchors[] | NN 2 IE 3 DOM 1
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.
Exemple
    var aCount = document.anchors.length;
Valeur
Tableau d´objets éléments anchor.
Par défaut
Tableau de longueur zéro.

applets[] | NN 2 IE 3 DOM 1
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.
Exemple
    var appletCount = document.applets.length
Valeur
Tableau d´objets éléments applet.
Par défaut
Tableau de longueur zéro.

bgColor | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Lorsque la propriété bgColor d'un document est définie dans Navigator 2 ou 3 pour Macintosh ou Unix, la fenêtre n'est pas correctement redessinée. Sur ces plates-formes, le contenu de la fenêtre est masqué par la nouvelle couleur. Pour les navigateurs qui prennent en charge l´objet document.body, utilisez plutôt la propriété bgColor de cet objet.
Exemple
    document.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.
Par défaut
Varie selon le navigateur et le système d'exploitation.

body | NN 6 IE 4 DOM 1
| Lecture seule
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.
Exemple
    document.body.leftMargin = 15;
Valeur
Référence d´objet
Par défaut
L'objet body courant.

charset | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
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.
Exemple
    if (document.charset == "csISO5427Cyrillic") {
        // process for Cyrillic charset
    }
Valeur
Alias insensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
Par défaut
Déterminée par le navigateur.

characterSet | NN 6 IE s.o. DOM s.o.
| Lecture seule
Indique l´encodage de caractère du contenu du document.
Exemple
    if (document.characterSet == "ISO-8859-1") {
        // process for standard Latin character set
    }
Valeur
Alias insensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
Par défaut
Déterminée par le navigateur.

compatMode | NN 7 IE 6 DOM s.o.
| Lecture seule
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.
Exemple
    if (document.compatMode == "BackCompat") {
        // process as if IE 5.5 or earlier or Netscape "quirks" mode
    }
Valeur
Constante sous forme de chaîne: BackCompat | CSS1Compat.
Par défaut
BackCompat

cookie | NN 2 IE 3 DOM 1
| Lecture/écriture
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:
Pour un domaine donné, jusque vingt de ces paires peuvent être enregistrées dans la propriété cookie (quel que soit le nombre de documents HTML utilisés dans ce site Web). Il est possible de stocker jusqu´à 4 000 caractères dans le cookie. Il est néanmoins conseillé de ne pas dépasser une longueur de 2 000 caractères pour chaque paire nom / valeur. Le code de votre script devra analyser la valeur de la propriété cookie pour y trouver une valeur précise.
L'écriture de valeurs dans la propriété cookie permet d'utiliser un plus grand nombre de paires de données facultatives associées à une seule paire nom / valeur. Les données de cookies doivent apparaître sous forme de chaîne, mais vous pouvez transformer un tableau en chaîne avec la méthode Array.join() pour écrire la valeur de cookie, puis utiliser la méthode String.split() pour reconstruire le tableau après avoir consulté les données de cookies. Le format se présente comme suit:
Quel que soit le nombre de sous-propriétés facultatives définies pour chaque cookie, seule la paire nom /valeur peut être extraite. Toutes les données de cookie écrites dans la propriété cookie sont conservées dans la mémoire du navigateur jusqu'à l'arrêt du navigateur. Lorsqu'une date d'expiration est incluse dans les données du cookie et que cette date n'a pas encore expiré, les données du cookie sont enregistrées dans le fichier de cookies actuel; sinon, les données sont ignorées. Lors du lancement suivant du navigateur, les données de cookies expirées sont automatiquement supprimées.
Exemple
    var exp = new Date();
    var nowPlusOneWeek = exp.getTime() + (7 * 24 * 60 * 60 * 1000);
    exp.setTime(nowPlusOneWeek);
    document.cookie = "userName=visitor; expires=" + exp.toGMTString();
Valeur
Données de cookie sous forme de chaîne. Voir description
Par défaut
Aucune.

defaultCharset | NN s.o. IE 4 DOM s.o.
| Lecture seule
Indique l´encodage de caractères du contenu du document.
Exemple
    var cset = document.defaultCharset;
Valeur
Alias insensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
Par défaut
Déterminée par le navigateur.

defaultView | NN 6 IE s.o DOM 2
| Lecture seule
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().
C´est la façon la plus proche que le DOM W3C DOM niveau 2 a de reconnaître l´existence d´un objet window. Cela sera développé plus avant dans le niveau 3.
Exemple
    var theWin = elemRef.ownerDocument.defaultView;
Valeur
Référence à un objet window.
Par défaut
La fenêtre du document.

doctype | NN 6 IE 5(Mac) DOM 1
| Lecture seule
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.
Exemple
    var docsType = document.doctype;
Valeur
Référence de noeud.
Par défaut
Aucune.

documentElement | NN 6 IE 5 DOM 1
| Lecture seule
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.
Exemple
    var rootElem = document.documentElement;
Valeur
Référence de noeud de l´élément.
Par défaut
L'objet élément html courant.

domain | NN 3 IE 4 DOM 1
| Lecture/écriture
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é.
Exemple
    document.domain = "megaCorp.com";
Valeur
Chaîne du nom de domaine commun à deux documents (nom du serveur non compris).
Par défaut
Aucune.

embeds[] | NN 3 IE 4 DOM s.o.
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.
Exemple
    var embedCount = document.embeds.length;
Valeur
Tableau des références des objets embed.
Par défaut
Tableau de longueur zéro.

expando | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
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.
Exemple
    document.expando = false;
Valeur
Valeur booléenne: true | false.
Par défaut
true

fgColor | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    document.fgColor = "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 (généralement noir).

fileCreatedDate | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var dateObj = new Date(document.fileCreatedDate);
Valeur
chaîne Date
Par défaut
Aucune.

fileModifiedDate | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var dateObj = new Date(document.fileModifiedDate);
Valeur
chaîne Date
Par défaut
Aucune.

fileSize | NN s.o. IE 4 DOM s.o.
| Lecture seule
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).
Exemple
    var byteCount = parseInt(document.fileSize, 10);
Valeur
Nombre entier sous la forme d´une chaîne (Windows) ou d´un nombre (Mac).
Par défaut
Aucune.

fileUpdatedDate | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie une chaîne vide. Apparemment pas de prise en charge officielle pour l´objet document.

forms[] | NN 2 IE 3 DOM 1
| Lecture seule
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.
Exemple
    var elemCount = document.forms[0].elements.length;
Valeur
Tableau d´objets form.
Par défaut
Tableau de longueur zéro.

frames[] | NN s.o. IE 4 DOM s.o.
| Lecture seule
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").
Exemple
    var iframeCount = document.frames.length;
Valeur
Tableau d´objets iframe.
Par défaut
Tableau de longueur zéro.

height, width | NN 4 IE s.o. DOM s.o.
| Lecture seule
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.
Exemple
    var howTall = document.height;
Valeur
Nombre de pixels.
Par défaut
Taille du document actuel.

ids[] | NN |4| IE s.o. DOM n/a
| Lecture seule
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.

images[] | NN 2 IE 3 DOM 1
| Lecture seule
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.
Exemple
    document.images["home"].src = "images/homeHilite.jpg";
Valeur
Tableau d´objets img.
Par défaut
Tableau de longueur zéro.

implementation | NN 6 IE 5(Mac)/6(Win) DOM 1
| Lecture seule
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.
Exemple
    var xDoc = document.implementation.createDocument("", "theXdoc", null);
Valeur
Référence à un objet DOMImplementation.
Par défaut
Objet DOMImplementation courant.

lastModified | NN 2 IE 3 DOM s.o.
| Lecture seule
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.
Exemple
    document.write(document.lastModified);
Valeur
Représentation d'une date et d´une heure sous la forme de chaîne.
Par défaut
Aucune.

layers[] | NN |4| IE s.o. DOM n/a
| Lecture seule
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.
Exemple
    if (document.layers) {
        // use document.layers[] syntax for references
    }
Valeur
Tableau d´objets layer ou leur équivalent.
Par défaut
Tableau de longueur zéro.

linkColor | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    document.link Color= "#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.
Par défaut
#0000FF

location | NN <6 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    document.location = "products/widget33.html";
Valeur
Adresse URL complète ou relative sous forme de chaîne.
Par défaut
Adresse URL du document.

media | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture/écriture
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.

mimeType | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var what = document.mimeType;
Valeur
Chaîne.
Par défaut
"HTML Document"

nameProp | NN s.o. IE 6 (Win) DOM s.o.
| Lecture seule
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.
Valeur
Chaîne.
Par défaut
Une chaîne vide.

namespaces[] | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var IENSCount = document.namespaces.length;
Valeur
Tableau des références des objets namespace.
Par défaut
Tableau de longueur zéro.

parentWindow | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var siblingCount = document.parentWindow.frames.length;
Valeur
Référence de l'objet window ou frame.
Par défaut
Objet window.

plugins[] | NN 4 IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var embedCount = document.plugins.length;
Valeur
Tableau des références des objets embed.
Par défaut
Tableau de longueur zéro.

protocol | NN s.o. IE 4 DOM s.o.
| Lecture seule
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).
Exemple
    if (document.protocol == "File Protocol") {
        // process for file access in IE
    }
Valeur
Chaîne en anglais.
Par défaut
Type de protocole du document courant.

readyState | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    if (document.readyState == "loading") {
        // statements for alternate handling
    }
Valeur
Une des valeurs suivantes, sous forme de chaîne: complete | interactive | loading | uninitialized. Certains éléments permettent à l'utilisateur d'interagir avec une partie du contenu. Dans ce cas, la propriété peut renvoyer la valeur interactive jusqu'à ce que le chargement soit terminé.
Par défaut
Aucune.

referrer | NN 2 IE 3 DOM 1
| Lecture seule
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.
Exemple
    if (document.referrer) {
        document.write("<p>Thanks for following the link to our web site.</p>");
    }
Valeur
Chaîne.
Par défaut
Aucune.

scripts[] | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var scriptCount = document.scripts.length;
Valeur
Tableau des références des éléments script.
Par défaut
Tableau de longueur zéro.

security | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie une chaîne décrivant la politique de sécurité mise en oeuvre pour le document courant.
Exemple
    var secPolicy = document.security;
Valeur
Chaîne.
Par défaut
« Ce type de document n´a pas de certificat de sécurité. »

selection | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var range = document.selection.createRange();
Valeur
Référence d´objet
Par défaut
Aucune.

styleSheets[] | NN 6 IE 4 DOM 2
| Lecture seule
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.
Exemple
    for (var i = 0; i < document.styleSheets.length; i++) {
        // loop through each styleSheet object
    }
Valeur
Tableau des références des objets styleSheet.
Par défaut
Tableau de longueur zéro.

tags[] | NN |4| IE s.o. DOM n/a
| Lecture seule
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.
Exemple
    document.tags.H1.color= "red";
Valeur
Tableau des références d´objets tag de feuilles de style JavaScript Navigator 4.
Par défaut
Tableau de longueur zéro.

title | NN 2 IE 3 DOM 1
| Lecture/écriture
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.
Exemple
    document.title = "Fred\'s Home Page";
Valeur
Chaîne.
Par défaut
Aucune.

URL | NN 3 IE 4 DOM 1
| Lecture/écriture
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.
Exemple
    document.URL = "http://www.megacorp.com";
Valeur
Adresse URL complète ou relative, sous forme de chaîne.
Par défaut
L'adresse URL du document courant.

URLUnencoded | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var straightPath = document.URLUnencoded;
Valeur
Adresse URL complète ou relative, sous forme de chaîne.
Par défaut
L'adresse URL du document courant.

vlinkColor | NN 2 IE 3 DOM s.o.
| Lecture/écriture (Internet Explorer)
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.
Exemple
    document.vlinkColor = "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); #800080 (Internet Explorer pour Windows); #006010 (Internet Explorer pour Macintosh).

width |
Voir height.

addBinding(), getAnonymousElementByAttribute(), getAnonymousNodes(), getBindingParent(), loadBindingDocument(), removeBinding() | NN 6 IE s.o. DOM s.o.
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.

captureEvents() | NN 4 IE s.o. DOM s.o.
captureEvents(eventTypeList) |
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.
Paramètres
Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event statiques disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
Valeur renvoyée
Aucune.

clear() | NN 2 IE 3 DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

close() | NN 6 IE 3 DOM 2
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

createAttribute() | NN 6 IE 5(Mac)/6(Win) DOM 1
createAttribute("attributeName") |
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.
Paramètres
Une chaîne, sensible à la casse, du nom de l´attribut.
Valeur renvoyée
Référence de l'objet noeud Attr.

createAttributeNS() | NN 6 IE s.o DOM 2
createAttributeNS("namespaceURI", "qualifiedName") |
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.
Paramètres
Chaîne d´URI correspondant à une URI affectée à une précedente étiquette dans le document, à laquelle l´attribut finit par être ajouté. Le nom complet de l´attribut, composé du préfixe de nom local (le cas échéant), d´un signe deux-points et du nom local.
Valeur renvoyée
Référence de l'objet noeud Attr.

createCDATASection() | NN 6 IE 5(Mac) DOM 1
createCDATASection("data") |
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.
Paramètres
Données, sous forme de chaîne, qui comprennent le contenu de la section.
Valeur renvoyée
Référence de l'objet noeud CDATASection.

createComment() | NN 6 IE 5(Mac)/6(Win) DOM 1
createComment("commentText") |
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.
Paramètres
Script contenant les données de commentaire.
Valeur renvoyée
Référence de l'objet noeud Comment.

createDocumentFragment() | NN 6 IE 5(Mac)/6(Win) DOM 1
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.
Paramètres
Aucune.
Valeur renvoyée
Référence de l'objet noeud DocumentFragment.

createElement() | NN 6 IE 4 DOM 1
createElement("nom_balise") |
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).
Paramètres
Une chaîne du nom de balise du nouvel événement: document.createElement("option"). IE autorise aussi une chaîne de balise de début complète, avec crochets et paires de noms d´attribut/valeurs. Seul le nom de balise brut est pris en charge par la spécification DOM W3C.
Valeur renvoyée
Référence de l'objet élément.

createElementNS() | NN 6 IE s.o DOM 2
createElementNS("namespaceURI", "qualifiedName") |
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.
Paramètres
Chaîne d´URI correspondant à une URI affectée à une étiquette précédemment dans le document, à laquelle l´attribut finit par être ajouté. Le nom complet de l´attribut, composé du pr_3fixe de nom local (le cas échéant), d´un signe deux-points et du nom local.
Valeur renvoyée
Référence de l'objet élément.

createEntityReference() | NN 6 IE 5(Mac) DOM 1
createEntityReference("entityName") |
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.
Paramètres
Valeur de chaîne.
Valeur renvoyée
Référence de l'objet noeud de référence d´entité.

createEvent() | NN 6 IE s.o DOM 2
createEvent("eventType") |
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:
Un tel événement peut alors être transmis à un élément (avec la méthode dispatchEvent() de l´élément) de façon à ce que l´auditeur d´événements de l´élément puisse traiter l´événement comme s´il avait été généré par un clic de souris de l´utilisateur.
Paramètres
Constante, sous forme de chaîne, pour l´une des catégories d´événements: HTMLEvents, KeyEvents (prise en charge par Netscape 6, mais non spécifiée jusqu´au DOM niveau 3), MouseEvents, MutationEvents ou UIEvents.
Valeur renvoyée
Référence de l'objet Event.

createEventObject() | NN s.o. IE 5,5 (Win) DOM s.o.
createEventObject([existingEventObject]) |
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:
Vous pouvez aussi utiliser un objet événement existant comme modèle pour un événement généré par script. Transmettez l´objet event courant comme paramètre de la méthode createEventObject() et modifiez les propriétés du nouvel objet comme vous le désirez.
Paramètres
Référence à un objet event généré par l´utilisateur ou par le script. Le nouvel événement adopte toutes les propriétés de l´objet événement existant.
Valeur renvoyée
Référence de l'objet event.

createNodeIterator() | NN s.o. IE s.o. DOM 2
createNodeIterator(rootNode, whatToShow, filterFunction, entityRefExpansion) |
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.
Paramètres
Comme un objet NodeIterator ne conserve pas sa liste de noeuds sous la forme d´une hiérarchie, les valeurs NodeFilter.FILTER_REJECT et NodeFilter.FILTER_SKIP passent sur un noeud sans le moindre effet sur les noeuds enfants. Reportez-vous à l´objet TreeWalker pour un exemple de ce type de fonction.
NodeFilter.SHOW_ALL | NodeFilter.SHOW_ATTRIBUTE
NodeFilter.SHOW_CDATA_SECTION | NodeFilter.SHOW_COMMENT
NodeFilter.SHOW_DOCUMENT | NodeFilter.SHOW_DOCUMENT_FRAGMENT
NodeFilter.SHOW_DOCUMENT_TYPE | NodeFilter.SHOW_ELEMENT
NodeFilter.SHOW_ENTITY | NodeFilter.SHOW_ENTITY_REFERENCE
NodeFilter.SHOW_NOTATION | NodeFilter.SHOW_PROCESSING_INSTRUCTION
NodeFilter.SHOW_TEXT |
NodeFilter.FILTER_ACCEPT | NodeFilter.FILTER_REJECT
NodeFilter.FILTER_SKIP |
Référence à un noeud dans l´arborescence de documents qui devient le premier noeud dans la liste de noeuds de l´objet NodeIterator. Nombre entier correspondant à un des divers filtres intégrés permettant aux noeuds d´un seul type d´être inclus dans l´objet NodeIterator renvoyé par la méthode. L´objet NodeFilter contient des constantes qui devraient être utilisées comme des remplacements en anglais de cette valeur:
Référence à une fonction utilisateur qui peut filtrer les noeuds inclus dans l´objet NodeIterator plus avant. La fonction a un seul paramètre (une référence à un noeud à tester, invoquée automatiquement par l´objet NodeIterator). La valeur renvoyée par la fonction détermine si le noeud étant testé doit être inclus dans la liste de noeuds ou non. Les valeurs renvoyées sont des nombres entiers, mais l´objet NodeFilter fournit trois constantes que vous devriez utiliser comme remplacements en anglais:
La valeur booléenne qui contrôle si les noeuds de référence d´entité (que l´on trouve surtout dans les documents XML) doivent être traités comme des noeuds hiérachiques (true) ou non (false).
Valeur renvoyée
Référence de l'objet NodeIterator.

createProcessingInstruction() | NN 6 IE 5(Mac) DOM 1
createProcessingInstruction("target", "data") |
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.
Paramètres
Valeur de chaîne. Valeur de chaîne.
Valeur renvoyée
Référence de l'objet noeud d´instruction de traitement.

createRange() | NN 6 IE s.o DOM 2
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.
Paramètres
Aucune.
Valeur renvoyée
Référence de l'objet Range du DOM W3C.

createStyleSheet() | NN s.o. IE 4 DOM s.o.
createStyleSheet(["url"[, index]]) |
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.
IE pour Windows renvoie toujours une référence à un objet styleSheet; IE pour Macintosh renvoie une référence à l´objet nouvellement inséré, qui sera un élément style ou link, selon la composition du paramètre. L´élément style inséré n´est pas très utile pour ajouter une règle car vous ne pouvez pas référencer l´objet styleSheet. Pour la compatibilité avec les différents systèmes d´exploitation, il est préférable d´utiliser cette méthode avec les feuilles de style externes uniquement.
Paramètres
Chaîne contenant l'adresse URL d'un fichier de définition de feuille de style .css externe. Nombre entier facultatif, à base zéro, indiquant l'emplacement de la collection styleSheets[] où sera insérée cette nouvelle feuille de style. Par défaut, la feuille de style est ajoutée à la fin de la collection, mais cela est susceptible d'affecter les règles en cascade du document. Reportez-vous au chapitre 3.
Valeur renvoyée
référence d´objet styleSheet (Windows); référence d´objet élément style ou link (IE 5 et versions ultérieures pour Mac).

createTextNode() | NN 6 IE 5 DOM 1
createTextNode("text") |
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).
Paramètres
Une chaîne de caractères devant être affichés comme contenu une fois insérés dans l´arborescence de documents.
Valeur renvoyée
Référence de l'objet noeud Texte.

createTreeWalker() | NN 7 IE s.o DOM 2
createNodeIterator(rootNode, whatToShow, filterFunction, entityRefExpansion) |
Génère, dans la mémoire, une instance d´un objet TreeWalker.
Paramètres
Avec une valeur renvoyée de NodeFilter.FILTER_SKIP, les noeuds descendants du noeud omis peuvent encore se qualifier comme éléments de la liste de noeuds TreeWalker (si jamais ils « survivent » aux autres filtres). Une valeur renvoyée de NodeFilter.FILTER_REJECT empêche le noeud en train d´être testé et ses descendants d´être considérés comme éléments de l´objet TreeWalker. Reportez-vous à l´objet TreeWalker pour un exemple de ce type de fonction.
NodeFilter.SHOW_ALL | NodeFilter.SHOW_ATTRIBUTE
NodeFilter.SHOW_CDATA_SECTION | NodeFilter.SHOW_COMMENT
NodeFilter.SHOW_DOCUMENT | NodeFilter.SHOW_DOCUMENT_FRAGMENT
NodeFilter.SHOW_DOCUMENT_TYPE | NodeFilter.SHOW_ELEMENT
NodeFilter.SHOW_ENTITY | NodeFilter.SHOW_ENTITY_REFERENCE
NodeFilter.SHOW_NOTATION | NodeFilter.SHOW_PROCESSING_INSTRUCTION
NodeFilter.SHOW_TEXT |
NodeFilter.FILTER_ACCEPT | NodeFilter.FILTER_REJECT
NodeFilter.FILTER_SKIP |
Référence à un noeud dans l´arborescence de documents qui devient le premier noeud dans la liste de noeuds de l´objet TreeWalker. Nombre entier correspondant à un des divers filtres intégrés permettant aux noeuds d´un seul type d´être inclus dans l´objet TreeWalker renvoyé par la méthode. L´objet NodeFilter contient des constantes qui devraient être utilisées comme des remplacements en anglais de cette valeur:
Référence à une fonction utilisateur qui peut filtrer encore davantage les noeuds inclus dans l´objet TreeWalker La fonction a un seul paramètre (une référence à un noeud à tester, invoqué automatiquement par l´objet TreeWalker). La valeur renvoyée par la fonction détermine si le noeud à tester doit être inclus dans la liste des noeuds. Les valeurs renvoyées sont des nombres entiers, mais l´objet NodeFilter fournit trois constantes que vous devriez utiliser en anglais comme remplacements:
La valeur booléenne qui contrôle si les noeuds de référence d´entité (que l´on trouve surtout dans les documents XML) doivent être traités comme des noeuds hiérachiques (true) ou non (false).
Valeur renvoyée
Référence de l'objet TreeWalker.

elementFromPoint() | NN s.o. IE 4 DOM s.o.
elementFromPoint(x, y) |
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.
Paramètres
Distance horizontale en pixels par rapport au côté gauche de la fenêtre ou du cadre. Distance verticale en pixels par rapport au côté supérieur de la fenêtre ou du cadre.
Valeur renvoyée
Référence de l'objet élément.

execCommand() | NN s.o. IE 4 (Win) DOM s.o.
execCommand("nom_commande"[, drapeau_interface[, valeur]]) |
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.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D. Valeur booléenne facultative: true pour afficher, le cas échéant, toute interface utilisateur déclenchée par la commande; false pour éviter cet affichage. Valeur de paramètre pour la commande.
Valeur renvoyée
Valeur booléenne: true si la commande a abouti,false si elle a échoué.

getAnonymousElementByAttribute() |
Voir addBinding()

getAnonymousNodes() |
Voir addBinding()

getBindingParent() |
Voir addBinding()

getElementById() | NN 6 IE 5 DOM 1
getElementById("elementID") |
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.
Paramètres
Chaîne de l´ID de l´élément désiré.
Valeur renvoyée
Référence à un objet noeud d´élément.

getElementsByName() | NN 6 IE 5 DOM 1
getElementsByName("elementName") |
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.
Paramètres
Chaîne du nom de l´élément désiré.
Valeur renvoyée
Tableau de références à un objet noeud d´élément.

getSelection() | NN 4 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Chaîne.

handleEvent() | NN |4| IE s.o. DOM n/a
handleEvent(événement) |
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.
Paramètres
Objet event de Navigator 4.
Valeur renvoyée
Aucune.

hasFocus() | NN s.o. IE 6 DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Valeur booléenne: true | false.

importNode() | NN 6 IE s.o DOM 2
importNode(nodeReference, deepBoolean) |
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.
La méthode importNode() n´est pas responsable de la pérennité entre les documents. C´est là que, par exemple, une variable JavaScript entre en jeu. Comme avec cloneNode(), la méthode importNode() ne touche pas au noeud source.
Paramètres
Référence à un noeud dans un document chargé qui est différent (y compris un document non affiché chargé dans le navigateur avec la méthode document.implementation.createDocument()). Valeur booléenne qui contrôle si la copie comprend tous les noeuds imbriqués (true) ou seulement le noeud courant (false). Requise, mais applicable principalement aux noeuds d´éléments.
Valeur renvoyée
Référence à la copie importée de l´objet noeud.

loadBindingDocument() |
Voir addBinding()

open() | NN 2 IE 3 DOM 1
open(["MIMEType"][, "replace"]) |
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.
Paramètres
Informe le navigateur du type MIME des données à écrire dans les instructions suivantes. Navigator prend en charge: "text/html" | "text/plain" | "image/gif" | "image/jpeg" | "image/xbm" | "plugIn". Internet Explorer prend uniquement en charge "text/html". La présence de ce paramètre indique au navigateur de remplacer l'entrée du document courant dans l'historique par le document dont l'écriture est imminente.
Valeur renvoyée
Aucune.

queryCommandEnabled() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandEnabled("nom_commande") |
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.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
Valeur booléenne: true s'il est activé;false s'il ne l'est pas.

queryCommandIndeterm() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandEnabled("nom_commande") |
Détermine si la commande est dans un état indéterminé. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
Valeur booléenne: true | false.

queryCommandState() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandState("nom_commande") |
Détermine l'état courant de la commande indiquée. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
true si la commande a été exécutée;false si la commande n'a pas été exécutée;null si l'état ne peut pas être déterminé avec certitude.

queryCommandSupported() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandEnabled("nom_commande") |
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.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
Valeur booléenne: true | false.

queryCommandText() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandText("nom_commande") |
Renvoie le texte associé à la commande. Uniquement disponible dans Internet Explorer 4 pour les plates-formes Win32.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
Chaîne.

queryCommandValue() | NN s.o. IE 4 (Win) DOM s.o.
queryCommandValue("nom_commande") |
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.
Paramètres
Nom de la commande, sous forme de chaîne non sensible à la casse. Reportez-vous à l´annexe D.
Valeur renvoyée
Dépend de la commande.

recalc() | NN s.o. IE 5 (Win) DOM s.o.
recalc([allBoolean]) |
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é.
Paramètres
Lorsqu´elle est définie comme true, elle force le recalcul de toutes les expressions d´attributs dynamiques du document. La valeur par défaut, false, laisse le navigateur décider quelles expressions sont affectées par les modifications depuis le dernier recalcul manuel ou automatique.
Valeur renvoyée
Aucune.

releaseEvents() | NN 4 IE s.o. DOM s.o.
releaseEvents(liste_types_événements) |
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.
Paramètres
Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
Valeur renvoyée
Aucune.

removeBinding() |
Voir addBinding()

routeEvent() | NN 4 IE s.o. DOM s.o.
routeEvent(événement) |
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.
Paramètres
Objet event de Navigator 4
Valeur renvoyée
Aucune.

write(), writeln() | NN 2 IE 3 DOM s.o.
write("string1"[, ..."stringN"]) writeln("string1"[, ..."stringN"]) |
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().
L´utilisation de document.write() pour les balises <script> est problématique dans Navigator car souvent ce dernier interprète l´écriture de la balise de fin de script comme la fin du script effectuant l´écriture. Mais, vous devriez réussir si vous divisez la balise de fin de script en sections:
Si vous incluez le commentaire « hide script », écrivez-le comme suit:
La différence entre les deux méthodes est que document.writeln() ajoute un retour chariot au code source qu'elle écrit dans le document. Le contenu affiché n'en est pas affecté, mais la lecture du code source dynamique en est facilitée dans les versions de navigateur qui prennent en charge l'affichage de la source du contenu dynamique (Navigator 4 utilise la pseudo-URL wysiwyg;: dans la fenêtre d'affichage du code source).
Paramètres
Une valeur quelconque sous forme de chaîne, y compris des balises HTML.
Valeur renvoyée
Aucune.