L´objet Element du DOM W3C provient du module principal et représente le type d´objet élément que vous trouvez dans les véritables documents XML. Ce type de noeud hérite des propriétés et méthodes de l´objet Node racine et ajoute des capacités qui lui permettent d´agir comme conteneur d´autres noeuds. Les éléments des documents HTML sont de type HTMLDocument, qui hérite du formulaire de l´objet Element. Toutes les propriétés et méthodes de l´objet Element sont partagées par tous les objets éléments HTML, comme expliqué au début de ce chapitre.

Joint un comportement IE interne ou externe à l´élément courant. Une fois qu´un script a joint le comportement, l´élément répond aux événements définis par le comportement (le cas échéant) et fournit l´accès aux propriétés et méthodes associées au comportement. Un fichier de comportement externe doit être transmis à partir du même domaine (et protocole) que la page courante. Pour plus de détails sur l´application des comportements IE pour Windows, visitez http://msdn.microsoft.com/workshop/author/behaviors/overview.asp.

Renvoie un tableau de tous les objets éléments HTML que contient le formulaire 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. La collection va au-delà des générations d´éléments imbriqués de telle façon que document.all[] présente tous les éléments du document entier. Reportez-vous à l´objet all pour la liste de propriétés et méthodes propres à cette valeur de propriété.

Insère un nouvel élément en tant qu´élément enfant de l´objet considéré ou en tant que nouveau parent de l´objet considéré, selon la valeur du second paramètre. Le comportement par défaut est d´englober l´objet considéré dans le nouvel élément. Mais, vous pouvez aussi choisir d´insérer le nouvel élément en tant qu´élément enfant. Dans ce cas, si l´objet considéré est dans l´arborescence de documents (au lieu de simplement flotter dans la mémoire après sa création par le biais de document.createElement() ) et contient déjà des éléments enfants imbriqués, le nouvel élément est inséré de façon à ce que les enfants précédents deviennent des enfants de l´élément inséré (c´est-à-dire des petits-enfants de l´objet considéré). Ce comportement d´englobement est unique parmi les méthodes d´insertion d´éléments de Microsoft Internet Explorer et peut avoir un impact important sur l´arborescence de documents. A utiliser avec des précautions extrêmes.

Fournit un tableau d´URN (Uniform Resource Names) pour tous les comportements externes (fichiers .htc) associés à l´élément par le biais de la syntaxe de feuilles de style. Peut-être pour des raisons de sécurité, les entrées de chaînes de ce tableau sont toujours vides.

Spécifie si l´élément courant peut contenir d´autres éléments. La valeur de la propriété est basée sur les DTD HTML intégrées de Microsoft Internet Explorer pour Windows, qui définissent plusieurs éléments (comme <br> ) dans lesquels vous ne pouvez pas insérer de noeuds enfants.

Renvoie un tableau de tous les objets éléments HTML de premier niveau que contient l´élément courant. Cette collection diffère de la collection all[] car elle ne contient que des références aux enfants immédiats de l´élément considéré (alors que la collection all[] transcende les générations). Par exemple, document.body.children[] peut contenir un formulaire, mais aucune référence aux éléments de formulaire au sein de ce formulaire. Les éléments de ce tableau sont indexés (en base zéro) dans l'ordre dans lequel ils apparaissent dans le code source. Contrairement au tableau childNodes[] , la portée de cette propriété est l´élément, pas le noeud. Voir l'objet children .

Il s´agit d´un identifiant généralement utilisé pour associer un élément à une règle définie pour un sélecteur de classe dans une feuille de style. Vous pouvez modifier l´association de classe pour un élément à l´aide d´un script. Si le document inclut un autre sélecteur de classe et une autre règle de style, la modification de la propriété className de l´élément peut fournir un raccourci pour la modification de nombreuses propriétés de style en même temps.

Supprime tous les attributs de l´élément courant à l´exception des attributs id et name (s´ils sont spécifiés). Les caractéristiques d´affichage influencées par les attributs de l´élément supprimés ne sont plus appliquées à l´élément.

Simule l´action du clic d´un utilisateur sur l´élément. Déclenche un événement onclick dans Internet Explorer 4 et versions ultérieures, ainsi que Navigator 4 et versions ultérieures. Remarque: Dans les navigateurs antérieurs à IE 4 et Netscape 6, certains éléments ne sont pas prêts pour la méthode click() (ou de l´événement onclick ). De plus, ne vous attendez pas à ce tous les éléments dont l´état graphique change lorsque l´utilisateur clique dessus simulent le même changement d´état lors du clic défini par script. Par exemple, certaines versions de navigateurs Macintosh ne changent pas l´état d´activation d´une case à cocher lorsque le script invoque une méthode click() sur une case à cocher. Dans ce cas, invoquez la méthode click() seulement si un gestionnaire d´événements onclick exécute du code; mais définissez aussi la propriété checked de la case à cocher comme désiré.

Renvoie la valeur de l´attribut nommé de l´élément courant. Si l´attribut est représenté comme propriété dans le modèle d´objet, cette méthode renvoie la même valeur que lors de la lecture de la propriété de l´objet. C´est la meilleure méthode pour lire la valeur d´un attribut d´objet élément (c´est-à-dire sa propriété) sous le DOM W3C.

Renvoie une référence à un noeud d´attribut (objet Attr ) associé au nom. Ce type de noeud est le même que celui qui remplit le tableau renvoyé par la propriété attributes d´un élément, mais la méthode getAttributeNode() vous permet d´accéder directement à l´objet noeud Attr par nom. Plus utile dans les documents XML, dans lesquels un attribut peut transmettre des données importantes associées à l´élément. Reportez-vous à l'objet Attr pour plus de détails sur ce type de noeud.

Renvoie la valeur de l´attribut nommé localement avec un URI d´espace de nom correspondant dans l'élément courant. Cette méthode fonctionne comme getAttribute() , mais accepte les attributs pour les documents XML étiquetés selon une spécification d´espace de nom. Le document XML simple suivant utilise un espace de nom pour un attribut de l´élément libBook:title:

<?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 un tableau de tous les éléments descendant de l´élément courant dont le nom de balise correspond au paramètre de la méthode. Les éléments du tableau comprennent les enfants, les petits-enfants, etc., et suivent l´ordre du code source. L´élément considéré n´est pas inclus dans le tableau. En l´absence de correspondances, le tableau a une longueur de zéro.

Renvoie un tableau de tous les éléments descendant de l´élément courant qui ont un nom local correspondant au second paramètre de la méthode et un URI d´espace de nom (affecté ailleurs dans le document comme déclaration d´espace de nom) correspondant au premier paramètre de la méthode. Les éléments du tableau comprennent les enfants, les petits-enfants, etc., et suivent l´ordre du code source. L´élément courant n´est pas inclus dans le tableau. En l´absence de correspondances, le tableau a une longueur de zéro. Applicable principalement aux documents XML.

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.

Renvoie une valeur booléenne true si l´élément considéré a un attribut avec un nom local correspondant au second paramètre de la méthode et un URI d´espace de nom (affecté ailleurs dans le document comme déclaration d´espace de nom) correspondant au premier paramètre de la méthode.

Spécifie si le navigateur doit afficher un rectangle d´activation en pointillés autour de l´élément activé. L´élément peut toujours être activé s´il est possible de l´activer par défaut ou s´il a l´ensemble d´attributs tabindex . Lorsque cette propriété est définie comme true , il n´y a pas d´indice visuel quand à l´état d´activation.

Spécifie un identifiant unique qui distingue cet élément de tous les autres au sein du document. La valeur de cette propriété est le plus souvent utilisée pour assembler des références aux éléments, mais vous pouvez passer tous les éléments en revue pour voir s´il y a une correspondance de valeur id . Il n´est généralement pas recommandé de modifier la valeur de cette propriété pour un élément qui se trouve déjà dans l´arborescence de documents. Mais si un script crée un nouvel objet élément (par le biais de la méthode document.createElement() , par exemple), il peut affecter un identifiant unique à la propriété id de cet objet, puis ajouter l´élément à l´arborescence de documents.

Indique le texte affiché (mais pas les balises) de l´élément courant. Si vous voulez le texte affiché, ainsi que les balises HTML imbriquées, reportez-vous à innerHTML . Les modifications apportées à cette propriété ne sont pas affichées par le biais de l´analyseur HTML, ce qui signifie que les balises HTML que vous incluez sont traitées comme du contenu de texte affichable uniquement. Vous ne pouvez modifier cette propriété qu´une fois le document complètement chargé. Les modifications apportées à la propriété innerText ne s'affichent pas dans le code source lorsque vous affichez la source dans le navigateur. Cette propriété n'est pas prise en charge dans de nombreux objets de la version Macintosh de Microsoft Internet Explorer 4.

Insère un objet élément à la position désignée par rapport à l´élément considéré. En général, l´objet élément sur le point d´être inséré est créé séparément (par exemple, par le biais de document.createElement() ) ou il peut d´agir d´une référence à un objet qui se trouve déjà dans l´arborescence de documents, et la méthode amène alors l´objet à son nouvel emplacement avec la méthode insertAdjacentElement() .

Insère une chaîne de texte à l´emplacement désigné par rapport au HTML existant de l´élément. Si les balises HTML font partie du texte à insérer, le navigateur interprète les balises et effectue l´affichage désiré. Cette méthode n'est pas prise en charge dans de nombreux objets de la version Macintosh de Microsoft Internet Explorer 4.

Insère du texte à la position désignée par rapport au HTML existant de l´élément. Si les balises HTML font partie du texte à insérer, elles sont affichées telles quelles sur la page. Cette méthode n'est pas prise en charge dans de nombreux objets de la version Macintosh de Microsoft Internet Explorer 4.

Spécifie si les fonctions de modification par l´utilisateur de Microsoft Internet Explorer pour Windows sont activées pour l´élément considéré. Révèle si l´état de modification est explicitement défini pour l´élément ou hérité de l´arborescence de ses ancêtres.

Spécifie si l´élément considéré permet l´affichage du contenu sur plusieurs lignes. La plupart des conteneurs de texte autorisent les lignes multiples, mais d´autres types d´éléments, tels que un élément de saisie de texte, sont limités à l´affichage sur une seule ligne.

Copie les paires nom/valeur de l´attribut à partir de l´élément spécifié en tant que paramètre de l´élément considéré. Cela est utile pour copier un vaste ensemble d´attributs à partir d´un élément existant vers un élément nouvellement créé. Par défaut, la copie n´inclut pas les attributs id ou name de façon à ce que les deux éléments aient des identifiants différents à des fins de scripts et de formulaires. A partir de Microsoft Internet Explorer 5.5 pour Windows, un second paramètre booléen facultatif, si défini sur false , duplique aussi les attributs id et name .

En gros, ces propriétés fournissent la hauteur et la largeur du contenu de l´élément, mais avec quelques variations mineures dans les bordures et le remplissage de l´élément selon les versions du système d´exploitation de Microsoft Internet Explorer et les modes de compatibilité contrôlés par la déclaration DOCTYPE . La tendance est d´inclure la mesure des bordures et du remplissage, mais pas les marges, dans ces valeurs. Netscape 6 implémente ces propriétés pour des raisons de commodité, bien qu´elles ne fassent pas partie du DOM W3C. Pour en savoir plus, reportez-vous à la section 9.2 au début de ce chapitre.

En gros, ces propriétés fournissent les coordonnées gauche et supérieure du cadre de l´élément, mais avec quelques variations mineures dans le contexte du système de coordonnées (vis-à-vis de l´élément offsetParent ) selon les versions du système d´exploitation de Microsoft Internet Explorer et les modes de compatibilité contrôlés par la déclaration DOCTYPE . Netscape 6 implémente ces propriétés pour des raisons de commodité, bien qu´elles ne fassent pas partie du DOM W3C. Pour en savoir plus, reportez-vous à la section 9.2 au début de ce chapitre. Pour les éléments positionnés, fiez-vous plutôt aux propriétés style de l´élément qui contrôlent l´emplacement dans le document ou dans la zone d´affichage du navigateur.

Renvoie une référence à l´objet qui est le contexte de positionnement de décalage de l'élément courant. Pour la plupart des éléments sur une page IE et tous les éléments sur une page Netscape 6, il s´agit de l´objet body . Mais les éléments dans IE qui sont inclus dans des éléments div ou qui sont des cellules d´un tableau ont d´autres parents. De plus, pour les éléments imbriqués complexes, vous trouverez des variations importantes quant à l´objet renvoyé par cette propriété, selon la version du navigateur. Par exemple, la propriété offsetParent d´un élément td est l´élément père tr dans IE 4 pour Windows et l´élément table pour les versions ultérieures de Microsoft Internet Explorer pour Windows et toutes les versions de Microsoft Internet Explorer pour Macintosh. Netscape 6 considère toujours l´élément body comme offsetParent de l´élément td . Reportez-vous à la section 9.2 au début de ce chapitre pour un exemple d´utilisation de cette propriété afin de calculer la position précise d´un élément interne.

Indique le texte affiché et les balises HTML (c´est-à-dire le code source), y compris les balises de début et de fin de l´élément courant. Si vous ne voulez que le texte affiché, reportez-vous à outerText . Pour le code source qui exclut les balises de l´élément courant, reportez-vous à innerHTML . Une modification apportée à cette propriété qui inclut des balises HTML est affichée par le biais de l´analyseur HTML, comme si la nouvelle valeur faisait partie du code source d´origine. Vous ne pouvez modifier cette propriété qu´après chargement complet du document et vous pouvez même modifier le type de l´élément dont il s´agit ou le remplacer avec un contenu en texte clair. Les modifications apportées à la propriété outerHTML n´apparaissent pas dans le code source lorsque vous affichez la source dans le navigateur. Pour ajouter à du HTML existant, reportez-vous à la méthode insertAdjacentHTML() . Cette propriété n´est pas prise en charge pour de nombreux objets dans la version Macintosh de Microsoft Internet Explorer 4. L´équivalent DOM W3C nécessite de nombreuses manipulations des objets de niveau noeud, comme indiqué dans le chapitre 5.

Indique le texte affiché (mais pas les balises) de l´élément courant. Si vous voulez le texte affiché, ainsi que les balises HTML de l´élément, reportez-vous à outerHTML . Les modifications apportées à cette propriété ne sont pas affichées par le biais de l´analyseur HTML, ce qui signifie que les balises HTML que vous incluez sont traitées comme du contenu de texte affichable uniquement. Vous ne pouvez modifier cette propriété qu´une fois le document complètement chargé. Les modifications apportées à la propriété outerText n´apparaissent pas dans le code source lorsque vous affichez la source dans le navigateur. Cette propriété n'est pas prise en charge dans de nombreux objets de la version Macintosh de Microsoft Internet Explorer 4.

Renvoie une référence à l´élément père dans la hiérarchie contenant-contenu HTML. Le parent HTML d´un élément n´est pas nécessairement identique à l´objet renvoyé par la propriété offsetParent . parentElement se rapporte uniquement à la contenance du code source, alors que la propriété offsetParent recherche l´élément père utilisé comme système de coordonnées afin de mesurer l´emplacement de l´élément courant. Par exemple, si le document principal contient un élément p avec un élément em imbriqué, l´élément em a deux parents. L´élément p est la valeur parentElement renvoyée (à cause de la contenance du code source HTML), alors que l´élément body est la valeur offsetParent renvoyée (à cause de la contenance de l´espace des coordonnées).

Supprime l´attribut nommé de l´élément considéré. Une spécification IE 4 qui limitait la suppression des attributs aux attributs ajoutés par le biais de la méthode setAttribute() n´est pas applicable dans IE 5 et versions ultérieures ou Netscape 6. La suppression d´un attribut ne modifie pas le code source lorsqu´il est affiché dans le navigateur, mais affecte la façon dont le navigateur affiche l´élément. Le noeud ou la valeur de l´attribut ne sont plus disponibles après la suppression.

Supprime l´attribut de l´élément considéré indiqué par la référence de paramètre à un objet noeud Attr existant. Cela fournit une autre façon de supprimer un attribut d´un élément si le script n´a qu´une référence à l´objet noeud Attr , et non à son nom. La suppression d´un noeud d´attribut ne modifie pas le code source lorsqu´il est affiché dans le navigateur, mais affecte la façon dont le navigateur affiche l´élément. Le noeud ou la valeur de l´attribut ne sont plus disponibles après la suppression.

Supprime l´attribut nommé localement avec un URI d´espace de nom correspondant de l'élément considéré. Cette méthode fonctionne comme removeAttribute() , mais accepte les attributs pour les documents XML étiquetés selon une spécification d´espace de nom. Le document XML simple suivant utilise un espace de nom pour un attribut de l´élément libBook:title:

<?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>?

Déconnecte l´association entre l´élément considéré et le comportement activé précédemment par le biais de la méthode addBehavior() . Le paramètre est la valeur qui a été renvoyée par la méthode addBehavior() , que vous devez conserver comme variable entre les invocations des deux méthodes.

Fait défiler le contenu où se trouve l´élément considéré de façon à ce qu´il devienne visible. Le comportement par défaut est d´afficher l´élément de façon à ce que le haut de l´élément se trouve en haut de l´espace de défilement. Mais vous pouvez aussi aligner l´élément en bas de l´espace de défilement si vous préférez.

Fait de l´élément considéré l´élément actif sans faire défiler la page pour pouvoir rendre l´élément actif visible. Cette méthode ne change pas non plus l´activation des fenêtres ou des cadres si elle est invoquée pour une autre fenêtre. Cependant, l´élément reçoit un événement onfocus lors de l´invocation de la méthode.

Définit la valeur de l´attribut nommé dans l´élément considéré. Si l´attribut est représenté comme propriété dans le modèle d´objet, cette méthode se comporte comme l´affectation d´une valeur à la propriété de l´objet. Malgré tout, le DOM W3C déclare que la méthode setAttribute() est le meilleur moyen de modifier la valeur d´un attribut (et que la méthode getAttribute() est le meilleur moyen de lire la valeur).

Insère ou remplace un attribut dans l´élément considéré. Le paramètre est une référence à un objet noeud Attr nouvellement créé ou référencé à partir d´un autre élément de l´arborescence de documents. Lorsque la méthode setAttributeNode() est invoquée, le navigateur commence par rechercher une correspondance entre le nom du nouvel attribut et les noms des attributs existants. Si une correspondance existe, le nouvel attribut remplace l´attribut d´origine; sinon, le nouvel attribut est ajouté aux attributs de l´élément. L´ajout d´un noeud d´attribut ne modifie pas le code source lorsqu´il est affiché dans le navigateur, mais affecte la façon dont le navigateur affiche l´élément si l´attribut affecte la représentation visuelle de l´élément. La valeur du nouvel attribut peut être obtenue par le biais de la méthode getAttribute() .

Insère ou remplace un attribut dans l´élément considéré. Le paramètre est une référence à un objet noeud Attr nouvellement créé ou référencé à partir d´un autre élément de l´arborescence de documents. Lorsque la méthode setAttributeNodeNS() est invoquée, le navigateur commence par rechercher une correspondance entre le nom local et l´URI d´espace de nom du nouvel attribut et les noms locaux et URI d´espace de nom des attributs existants. Si une correspondance existe, le nouvel attribut remplace l´attribut d´origine; sinon, le nouvel attribut est ajouté aux attributs de l´élément. L´ajout d´un noeud d´attribut ne modifie pas le code source lorsqu´il est affiché dans le navigateur, mais affecte la façon dont le navigateur affiche l´élément si l´attribut affecte la représentation visuelle de l´élément. La valeur du nouvel attribut peut être obtenue par le biais de la méthode getAttributeNS() .

Insère ou remplace un attribut dans l´élément considéré. S´il y a une correspondance entre les attributs de l´élément pour l´URI d´espace de nom ET le nom qualifié transmis comme paramètres, la nouvelle valeur est affectée à l´attribut existant. En l'absence de correspondance, l´attribut est ajouté à l´élément.

Pour les éléments personnalisés utilisant les espaces de nom XML, la propriété scopeName renvoie l´identifiant qui associe le nom de balise avec un espace de nom défini à un autre endroit du document par le biais de l´attribut xmlns . Tous les éléments HTML renvoient une valeur de HTML pour cette propriété. La propriété tagUrn renvoie l´URI spécifié pour l´espace de nom. Pour le DOM W3C, les propriétés correspondantes sont prefix et namespaceURI .

Renvoie l´index à base zéro de l´élément parmi tous les éléments du document. Les éléments sont numérotés suivant leur ordre dans le code source et pour le premier élément, un sourceIndex égal à zéro.

Renvoie le nom de la balise de l´élément courant. Les noms de balises sont toujours renvoyés tout en majuscules à des fins de comparaison de chaînes, quel que soit le style du code source ou la déclaration DOCTYPE .

Renvoie une chaîne d´identifiant qui est unique parmi tous les identifiants d´objets sur la page. Utilisée principalement pour affecter un ID aux éléments nouvellement créés, si le fait que le navigateur utilise son propre système d´affectation de noms ne vous gêne pas. Le plus souvent utilisée comme propriété de l´objet document , elle est malgré tout accessible par le biais de la référence de n´importe quel objet élément existant. Il est parfaitement valable d´utiliser l´identifiant comme un paramètre de chaîne pour les méthodes qui nécessitent un ID d´élément.

Insère ou remplace un attribut dans l'élément considéré. S'il y a une correspondance entre les attributs de l'élément pour l'URI d'espace de nom ET le nom qualifié transmis comme paramètres, la nouvelle valeur est affectée à l'attribut existant. En l'absence de correspondance, l'attribut est ajouté à l'élément.

Relie une fonction de gestionnaire d'événements à un objet élément pour un type d'événement particulier. Avec un fonctionnement similaire à la méthode addEventListener() du DOM W3C, la méthode attachEvent() de Microsoft Internet Explorer est utilisée principalement pour les comportements IE. La liaison d'événements par le biais des propriétés de gestionnaire d'événements des objets éléments est une meilleure approche multi-navigateurs pour les pages HTML normales. Si vous reliez un gestionnaire d'événements par le biais de la méthode attachEvent() , vous pouvez désactiver la liaison par le biais de la méthode detachEvent() .