Document

NN 6 IE s.o DOM 1

L´objet document décrit précédemment est, dans la structure du DOM W3C, un noeud HTMLDocument, un élément du module HTML de la norme. Le noeud HTMLDocument hérite des propriétés et des méthodes du noeud Document (avec un D majuscule comme décrit ici et défini dans le module principal du DOM W3C). Il s´agit du noeud Document pur, abstrait, et de tout ce qui est nécessaire pour contenir un document XML non affiché.

Netscape 6 élargit ce noeud avec une méthode load() qui permet aux scripts de charger des documents XML dans un noeud Document simple (et invisible). Pour créer un tel noeud, utilisez la méthode document.implementation.createDocument(). Les scripts peuvent alors accéder aux données XML de ce document en utilisant les propriétés et les méthodes d´arborescence de documents du DOM W3C habituelles.

Pour vous aider à renforcer dans votre esprit l´héritage de l´objet document que vous définissez normalement par script (c´est-à-dire l´instance du noeud HTMLDocument représentée dans le document de chaque fenêtre), voici les listes des propriétés et méthodes pour l´objet Document principal. Pour la description de toutes ces propriétés et méthodes, à l´exception de la méthode load() spécifique à Netscape 6, reportez-vous à l´objet document, traité précédemment dans ce chapitre.

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

documentNodeReference

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

doctype

documentElement

implementation

Méthodes spécifiques à l´objet

createAttribute()	createAttributeNS()	createCDATASection()
createComment()	createDocumentFragment()	createElement()
createElementNS()	createEntityReference()	createProcessingInstruction()
createTextNode()	getElementById()	getElementsByTagName()
getElementsByTagNameNS()	importNode()	load()

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

Aucune.

load()	NN 6 IE s.o. DOM s.o.
load("URI")
Charge un fichier XML dans l´objet Document courant. Les tentatives de chargement d´autres types de fichiers (tels que HTML) renvoient un exception. Le serveur doit être configuré pour envoyer le fichier comme type de contenu text/html.

Paramètres

Une chaîne de l´URI vers un fichier XML externe.

Valeur renvoyée
Aucune.

document	NN s.o. IE 4 DOM s.o.
	Lecture seule
Renvoie une référence à l'élément document qui contient l'élément courant. Peut être utile pour les fonctions qui agissent sur les références d´objet obtenues à partir de propriétés d´événements ou transmises comme chaînes d´ID> La propriété du DOM W3C correspondante est ownerDocument .

Exemple

var currDoc = document.getElementById("elementID").document;

Valeur
Référence de l'objet document .

Par défaut
L'objet document courant.

title	NN 6 IE 4 DOM 1
	Lecture/écriture
Fournit une description de l'élément. Lorsqu'il s'agit d'un élément qui a une présence physique sur la page, le navigateur affiche la valeur de cette propriété sous la forme d'une étiquette de texte flottant lorsque le curseur se trouve sur l'élément. La taille, les caractéristiques de police et la couleur de cette étiquette ne peuvent pas être contrôlées par script.

Exemple

document.getElementById("elementID").title = "Hot stuff!";

Valeur
Chaîne.

Par défaut
Une chaîne vide.

readyState	NN s.o. IE 4 DOM s.o.
	Lecture seule
Renvoie l'état courant du téléchargement du contenu de l'objet. 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 (l'événement ne remonte pas).

Lors de son introduction dans IE 4, la propriété n'était disponible que pour les objets document , embed , img , link , object , script et style . IE 5 a élargi la prise en charge à tous les objets éléments HTML.

Exemple

if (document.readyState == "loading") { //statements for alternate handling while loading }

Valeur
Pour tous les éléments sauf object , une des valeurs suivantes, sous forme de chaîne: uninitialized \| loading \| loaded \| interactive \| complete . 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é. Certains types d'éléments ne renvoient pas toutes les valeurs dans l'ordre pendant le processus de chargement. L'élément object renvoie des valeurs numériques pour ces cinq états. Elles vont de 0 (uninitialized ) à 4 (complete ).

Par défaut
Aucune.