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