L´objet Node est une représentation abstraite dans le DOM W3C du bloc de création du contenu fondamental dans un document. Tous les morceaux de contenu que vous pouvez traiter dans le modèle DOM W3C sont des noeuds: Les chaînes de texte contiguës sans nom entre les balises, les éléments avec balises, les paires d´attributs nom/valeur, les éléments ayant une fonction spéciale tels que les commentaires, les déclarations DOCTYPE et même le document lui-même, pour en citer quelques-uns.

Relie une fonction de gestionnaire d´événements au noeud courant de façon à ce que la fonction soit exécutée lorsqu´un événement d´un type particulier arrive au noeud comme cible d´événement ou pendant la propagation des événements. Remarque: Les événements du DOM W3C se propagent par le biais des noeuds de texte, ainsi que des noeuds éléments. Le noeud « écoute » pour repérer le type d´événement pendant la capture d´événements ou la propagation par remontée, selon le paramétrage du troisième paramètre booléen. Vous pouvez invoquer cette méthode plusieurs fois pour le même noeud, mais avec des valeurs de paramètres différentes afin d´affecter autant de comportements de traitement d´événements que vous le désirez, mais vous ne pouvez invoquer qu´une une seule fonction d´auditeur pour le même type d´événement et de propagation. Si l´auditeur d´événements est ajouté de façon temporaire, vous pouvez le supprimer par le biais de la méthode removeEventListener() .

Insère un nouveau noeud à la suite du dernier noeud enfant de l´objet noeud considéré. L´objet noeud courant doit être capable de contenir des noeuds enfants, sinon la méthode renvoie une exception. Cette méthode est la façon la plus courante d´ajouter un élément, un noeud de texte ou un fragment de document créé dynamiquement à un élément existant, comme peut le faire un script lors de l´assemblage d´une section de contenu nouveau pour un document. Mais si la référence de noeud transmise comme paramètre avec la méthode appendChild() pointe sur un noeud existant dans l´arborescence de documents, ce noeud est supprimé de l´arborescence, puis ajouté à la fin de la liste des noeuds enfants de l´objet courant. Cela fournit un raccourci pour déplacer un noeud d´un emplacement à la fin d´un conteneur.

Cet ensemble de constantes appartient à l´objet Node racine du DOM W3C et est donc hérité par tous les éléments et noeuds de niveau document. Chaque propriété correspond à un nombre entier associé à la propriété nodeType de chaque noeud du DOM. Vous pouvez utiliser ces propriétés comme un moyen plus clair d´indiquer le type de noeud que votre script recherche dans les comparaisons ou opérations similaires.

Renvoie un objet carte noeud nommé, qui ressemble à un tableau (collection) d´objets attributs (type Attr du DOM W3C), mais a aussi des méthodes qui lui sont propres afin de faciliter l´accès à un élément de ce tableau. Le tableau attributes IE contient des entrées pour tous les attributs de la DTD interne de l´élément, plus tout attribut personnalisé (expando ) explicitement défini pour IE 6 dans le code source HTML. Les modifications apportées par script aux attributs de l´élément ou à leurs valeurs ne sont pas représentées dans ce tableau.

C´est une propriété de l´objet Node du DOM W3C composée d´un tableau de références à tous les noeuds enfants (une liste de noeuds) dans le niveau inférieur de la hiérarchie des noeuds (qu´il s´agisse de parties de l´arborescence de noeuds ou de fragments de documents autonomes pas encore insérés dans l´arborescence de documents). Pour accéder aux noeuds imbriqués plus profondément (à des niveaux encore inférieurs), vous devez accéder au tableau childNodes de chaque noeud enfant du noeud courant. Une propriété essentielle pour parcourir une arborescence de noeuds. Reportez-vous à l´objet NodeList pour les propriétés et méthodes de ce genre de tableau.

Renvoient une référence au premier ou dernier noeud enfant (respectivement) du noeud élément courant. Le plus souvent, ces noeuds enfants sont des noeuds de texte imbriqués dans un élément. Pour un simple élément contenant un seul noeud de texte, les deux propriétés renvoient une référence au même noeud de texte. Pour les constructions plus complexes, telles que les éléments tr , d´autres noeuds éléments (éléments td ) peuvent être leurs noeuds enfants, mais certains navigateurs risquent de convertir les retours chariot entre les éléments du code source en noeuds de texte. Ainsi, il vaut mieux valider le type de noeud renvoyé par les propriétés avant d´agir dessus.

Renvoie une valeur booléenne true si l´élément considéré a un ou des attributs explicitement affectés dans la balise.

Renvoie une valeur booléenne true si le noeud considéré contient un ou plusieurs noeuds enfants.

Insère un noeud en tant qu´enfant du noeud considéré (en général, ce noeud est un élément) avant un des autres noeuds enfants du noeud courant. Le nouvel enfant peut être une référence à un noeud existant dans l´arborescence de documents (auquel cas il est supprimé de sa position d´origine lors de l´invocation de cette méthode). Le noeud enfant peut aussi être nouvellement créé comme n´importe quel type de noeud du DOM valide, notamment un fragment de document (pouvant contenir des balises HTML) ou Attr (ce dernier est implémenté pour Netscape 6 et IE 6).

Renvoie la valeur booléenne true si le noeud considéré prend en charge (c´est-à-dire se conforme aux spécifications) un module et une version du DOM W3C donnés. Bien que la méthode hasFeature() de l´objet document.implementation effectue le même test, elle le fait sur l´ensemble de l´application du navigateur.La méthode isSupported() effectue le test sur un noeud individuel, vous permettant de vérifier la prise en charge des fonctionnalités pour le type de noeud considéré. Les valeurs de paramètres pour isSupported() sont les mêmes que pour document.implementation.hasFeature() .

Voir firstChild.

Ces trois propriétés s´appliquent principalement aux éléments de document XML avec des balises définies à l´aide d´espaces de nom XML. Voici un exemple simplifié d´un tel document:

<?xml version="1.0" encoding="ISO-8859-1">
<results xmlns:libBook="http://catalog.umv.edu/schema">
<libBook:title libBook:rareBooks="true">De Principia</libBook:title>
</results>?

Renvoie une référence au noeud précédent ou suivant (respectivement) dans l´arborescence de documents, au même niveau d´imbrication que le noeud courant. Si aucun noeud ne se trouve à la position indiquée par le nom de la propriété, la méthode renvoie null . Pour un seul noeud de texte au sein d´un noeud élément, les deux propriétés renvoient null . La séquence des noeuds est initialement déterminée par l´ordre du code source, mais les modifications de l´arborescence de documents apportées par script sont reflétées dans les noeuds renvoyés par ces propriétés.

Renvoie une chaîne qui identifie le nom du noeud comme influencé par le type de noeud. Pour les types de noeuds éléments et attributs, la propriété renvoie le nom de la balise et le nom de l´attribut, respectivement. Pour de nombreux autres types de noeuds, auxquels aucune étiquette inhérente n´est associée, la propriété nodeName renvoie une chaîne fixe indiquant le type de noeud, telle que #text pour un noeud de texte et #document pour le noeud de document racine. Pour les éléments, la propriété renvoie la même valeur de chaîne que la propriété tagName de l´objet élément. Remarque: Les navigateurs jusqu´à IE 6 et Netscape 7 renvoie les chaînes de balise d´élément entièrement en majuscules, quel que soit le style du code source ou la spécification DOCTYPE .

Renvoie un nombre entier qui correspond au type de noeud comme spécifié dans le DOM W3C. Il s´agit de la propriété à utiliser en priorité pour tester le type d´un objet noeud (plutôt que les valeurs de la propriété nodeName ). Chaque type de noeud a une valeur, mais certains navigateurs qui prennent en charge la propriété nodeType ne prennent pas tous les types de noeud en charge en tant qu´objets. Des constantes correspondantes sont associées aux valeurs de nombres entiers et vous pouvez les utiliser pour créer des comparaisons de script plus longues, mais plus faciles à comprendre, pour le traitement du type de noeud (reportez-vous à la propriété ATTRIBUTE_NODE précédemment dans ce chapitre). Remarque: Il n´y a aucun moyen de distinguer les types d´élément (par exemple, noeud Element racine et noeud HTMLElement ) par le biais de la propriété nodeType . Notez aussi qu´IE 6 pour Windows indique de façon erronée qu´un élément DOCTYPE est un type de noeud de commentaire.

Fusionne tous les noeuds de texte frères du noeud (élément) considéré en un seul noeud de texte. L´invocation de cette méthode peut être nécessaire après l´insertion ou la suppression de noeuds enfants d´un élément, si vos scripts de parcours (traversée) de noeuds s´attendent à ce que tout texte contigu se trouve dans un seul noeud de texte. Le DOM W3C considère qu´une arborescence de documents est normale seulement si un noeud de texte n´a pas d´autres noeuds de texte pour frères.

Renvoie une référence à l´objet document qui contient le noeud 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é IE correspondante est document .

Renvoie une référence au noeud parent (généralement un élément) qui joue le rôle de conteneur pour le noeud courant dans l´arborescence de documents. La relation entre le noeud courant et son parent est purement structurelle et n´a rien à voir avec le contexte de positionnement. Un noeud parent est un noeud qui englobe complètement le noeud courant et ne doit pas être confondu avec les noeuds frères qui, au mieux, résident d´un seul côté du noeud courant. Vous pouvez utiliser les mêmes astuces liées à la structure en cascade que pour la propriété parentElement IE, mais il est risqué de faire correspondre les résultats des propriétés uniques à IE axées sur les éléments et les résultats des propriétés du DOM W3C axées sur les noeuds (bien que les versions de Microsoft Internet Explorer récentes prennent les deux points de vue en charge).

Supprime un noeud enfant de l´élément considéré. Le paramètre doit être une référence à un noeud enfant existant imbriqué à l´intérieur de l´élément considéré. Une fois supprimé, le noeud enfant ne fait plus partie de l´arborescence de documents, mais est conservé en mémoire. La méthode renvoie une référence au noeud supprimé afin que vous puissiez le modifier et le placer ailleurs dans l´arborescence de documents. Remarque: Vous pouvez demander à un noeud de supprimer l´un de ses enfants, mais vous ne pouvez pas lui demander de se supprimer lui-même (mais reportez-vous à removeNode() pour IE).

Remplace le noeud considéré par un nouveau noeud. Le nouveau noeud peut être créé de zéro (c´est-à-dire un élément ou un noeud de texte) ou peut être une référence à un noeud qui existe ailleurs dans l´arborescence de documents. Dans ce cas, l´invocation de la méthode replaceNode() supprime le noeud de son emplacement d´origine dans l´arborescence de documents et le place à l´emplacement du noeud considéré.

Echange le noeud considéré (dans l´arborescence de documents) avec un autre noeud transmis comme paramètre. L´autre objet noeud peut être créé de zéro ou peut être une référence à un noeud qui existe ailleurs dans l´arborescence de documents. Dans ce cas, le résultat est le même que celui d´un échange bidirectionnel, où les deux noeuds échangent leurs positions respectives. Si les deux noeuds sont d´un type de noeud différent ou ont un type d´affichage d´éléments distinct (par exemple, interne et de niveau bloc), l´affichage du document peut être affecté de façon importante.

Echange le noeud considéré (dans l'arborescence de documents) avec un autre noeud transmis comme paramètre. L'autre objet noeud peut être créé de zéro ou peut être une référence à un noeud qui existe ailleurs dans l'arborescence de documents. Dans ce cas, le résultat est le même que celui d'un échange bidirectionnel, où les deux noeuds échangent leurs positions respectives. Si les deux noeuds sont d'un type de noeud différent ou ont un type d'affichage d'éléments distinct (par exemple, interne et de niveau bloc), l'affichage du document peut être affecté de façon importante.

Cet ensemble de constantes appartient à l'objet Node racine du DOM W3C et est donc hérité par tous les éléments et noeuds de niveau document. Chaque propriété correspond à un nombre entier associé à la propriété nodeType de chaque noeud du DOM. Vous pouvez utiliser ces propriétés comme un moyen plus clair d'indiquer le type de noeud que votre script recherche dans les comparaisons ou opérations similaires.

Renvoient une référence au premier ou dernier noeud enfant (respectivement) du noeud élément courant. Le plus souvent, ces noeuds enfants sont des noeuds de texte imbriqués dans un élément. Pour un simple élément contenant un seul noeud de texte, les deux propriétés renvoient une référence au même noeud de texte. Pour les constructions plus complexes, telles que les éléments tr , d'autres noeuds éléments (éléments td ) peuvent être leurs noeuds enfants, mais certains navigateurs risquent de convertir les retours chariot entre les éléments du code source en noeuds de texte. Ainsi, il vaut mieux valider le type de noeud renvoyé par les propriétés avant d'agir dessus.

Ces trois propriétés s'appliquent principalement aux éléments de document XML avec des balises définies à l'aide d'espaces de nom XML. Voici un exemple simplifié d'un tel document:

Voir localName.

Voir localName.

Renvoie une référence au noeud précédent ou suivant (respectivement) dans l'arborescence de documents, au même niveau d'imbrication que le noeud courant. Si aucun noeud ne se trouve à la position indiquée par le nom de la propriété, la méthode renvoie null . Pour un seul noeud de texte au sein d'un noeud élément, les deux propriétés renvoient null . La séquence des noeuds est initialement déterminée par l'ordre du code source, mais les modifications de l'arborescence de documents apportées par script sont reflétées dans les noeuds renvoyés par ces propriétés.

Voir nextSibling.

Renvoie une valeur booléenne true si l'élément considéré a un attribut dont le nom correspond au paramètre de la méthode.