XML DOM - ElementObjet


Objet Element

L'objet Element représente un élément dans un document XML. Les éléments peuvent contenir des attributs, d'autres éléments ou du texte. Si un élément contient du texte, ce texte est représenté dans un nœud de texte.

Important :Le texte est toujours stocké dans des nœuds de texte. Une erreur courante dans le traitement DOM consiste à naviguer vers un nœud d'élément et à supposer que ce nœud contient du texte. Cependant, même le nœud d'élément le plus simple a un nœud de texte en dessous de lui. Par exemple, dans <year>2005</year>, il y a un nœud d'élément (year), et sous ce nœud se trouve un nœud de texte contenant le texte (2005).

Comme l'objet Element est aussi un nœud, il peut hériter des propriétés et méthodes de l'objet Node.

Propriétés de l'objet Element

Propriété Description
attributes Renvoie un NamedNodeMap des attributs de l'élément.
baseURI Renvoie l'URI de base absolue de l'élément.
childNodes Renvoie une NodeList des nœuds enfants de l'élément.
firstChild Renvoie le premier nœud enfant de l'élément.
lastChild Renvoie le dernier nœud enfant de l'élément.
localName Renvoie la partie locale du nom de l'élément.
namespaceURI Renvoie l'URI d'espace de noms de l'élément.
nextSibling Renvoie le nœud qui suit immédiatement l'élément.
nodeName Renvoie le nom du nœud, en fonction de son type.
nodeType Renvoie le type du nœud.
ownerDocument Renvoie l'élément racine (objet document) auquel appartient l'élément.
parentNode Renvoie le nœud parent de l'élément.
préfixe Définit ou renvoie le préfixe d'espace de noms de l'élément.
previousSibling Renvoie le nœud précédant immédiatement l'élément.
schemaTypeInfo Renvoie les informations de type associées à l'élément.
tagName Renvoie le nom de l'élément.
textContent Définit ou renvoie le contenu texte de l'élément et de ses descendants.

Méthodes de l'objet Element

Méthodes Description
appendChild() Ajoute un nouveau nœud enfant à la fin de la liste des enfants du nœud.
cloneNode() Clone le nœud.
compareDocumentPosition() Compare la position dans le document de deux nœuds.
getAttribute() Renvoie la valeur de l'attribut.
getAttributeNS() Renvoie la valeur de l'attribut (avec espace de noms).
getAttributeNode() Renvoie le nœud d'attribut sous la forme d'un objet Attribute.
getAttributeNodeNS() Renvoie le nœud d'attribut sous la forme d'un objet Attribute (avec espace de noms).
getElementsByTagName() Renvoie une NodeList de nœuds d'éléments correspondants et de leurs nœuds enfants.
getElementsByTagNameNS() Renvoie une NodeList de nœuds d'éléments correspondants (avec espace de noms) et de leurs nœuds enfants.
getFeature(feature,version) Renvoie un objet DOM qui peut exécuter une API spécialisée avec les fonctionnalités et la version spécifiées.
getUserData(key) Renvoie l'objet associé à une clé sur le nœud. Cet objet doit d'abord avoir été défini sur ce nœud en appelant setUserData avec la même clé.
hasAttribute() Indique si l'élément possède un attribut correspondant au nom spécifié.
hasAttributeNS() Indique si l'élément possède un attribut correspondant au nom et à l'espace de noms spécifiés.
hasAttributes() Indique si l'élément possède des attributs.
hasChildNodes() Indique si l'élément possède des nœuds enfants.
insertBefore() Insère un nouveau nœud enfant avant un nœud enfant existant.
isDefaultNamespace(URI) Renvoie si le namespaceURI spécifié est celui par défaut.
isEqualNode() Vérifie si deux nœuds sont égaux.
isSameNode() Vérifie si deux nœuds sont le même nœud.
isSupported(feature,version) Renvoie si la fonctionnalité spécifiée est prise en charge sur cet élément.
lookupNamespaceURI() Renvoie l'URI d'espace de noms correspondant au préfixe spécifié.
lookupPrefix() Renvoie le préfixe correspondant à l'URI de l'espace de noms spécifié.
normalize() Place tous les nœuds de texte sous le nœud (y compris les attributs) dans une forme "normale", où seule la structure (telle que les éléments, les commentaires, les instructions de traitement, les sections CDATA et les références d'entité) sépare les nœuds Text, par exemple, il n'existe ni nœuds Text adjacents ni nœuds Text vides.
removeAttribute() Supprime l'attribut spécifié.
removeAttributeNS() Supprime l'attribut spécifié (avec espace de noms).
removeAttributeNode() Supprime le nœud d'attribut spécifié.
removeChild() Supprime le nœud enfant.
replaceChild() Remplacer le nœud enfant.
setUserData(key,data,handler) Associe un objet à une clé sur l'élément.
setAttribute() Ajouter un nouvel attribut.
setAttributeNS() Ajoute un nouvel attribut (avec espace de noms).
setAttributeNode() Ajoute un nouveau nœud d'attribut.
setAttributeNodeNS(attrnode) Ajoute un nouveau nœud d'attribut (avec espace de noms).
setIdAttribute(name,isId) Si la propriété isId de l'objet Attribute est true, cette méthode déclare l'attribut spécifié comme attribut ID défini par l'utilisateur.
setIdAttributeNS(uri,name,isId) Si la propriété isId de l'objet Attribute est true, cette méthode déclare l'attribut spécifié comme attribut ID défini par l'utilisateur (avec espace de noms).
setIdAttributeNode(idAttr,isId) Si la propriété isId de l'objet Attribute est true, cette méthode déclare l'attribut spécifié comme attribut ID défini par l'utilisateur.

autres extensions