L'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, le texte est représenté dans un texte-noeud.
IMPORTANT! Le texte est toujours stocké dans les nœuds de texte. Une erreur courante dans le traitement DOM est de naviguer vers un noeud d'élément et espérer qu'il contient le texte. Cependant, même le nœud d'élément simple a un noeud de texte en dessous. Par exemple, en <year>2005</year> , il existe un nœud d'élément (year) , et un noeud de texte en dessous, qui contient le texte (2005) .
Parce que l'objet Element est aussi un nœud, il hérite des propriétés et méthodes de l'objet Node.
Propriétés de l'objet Element
| Propriété | La description |
|---|---|
| attributes | Renvoie un NamedNodeMap d'attributs pour l'élément |
| baseURI | Renvoie l'URI de base absolue de l'élément |
| childNodes | Renvoie un NodeList des nœuds enfants de l'élément |
| firstChild | Retourne le premier enfant de l'élément |
| lastChild | Retourne le dernier enfant de l'élément |
| localName | Retourne la partie locale du nom de l'élément |
| namespaceURI | Renvoie l'URI de l'élément |
| nextSibling | Retourne le noeud immédiatement après l'élément |
| nodeName | Renvoie le nom du noeud, en fonction de son type |
| nodeType | Retourne le type du noeud |
| ownerDocument | Renvoie l'élément racine (document object) pour un élément |
| parentNode | Renvoie au noeud parent de l'élément |
| prefix | Définit ou retourne le préfixe d'espace de noms de l'élément |
| previousSibling | Retourne immédiatement le nœud avant l'élément |
| schemaTypeInfo | Renvoie l'information de type associée à l'élément |
| tagName | Retourne le nom de l'élément |
| textContent | Définit ou renvoie le contenu du texte de l'élément et ses descendants |
Élément Méthodes d'objet
| méthode | La description |
|---|---|
| appendChild() | Ajoute un nouveau nœud enfant à la fin de la liste des enfants du nœud |
| cloneNode() | Clones un noeud |
| compareDocumentPosition() | Compare la position du document de deux noeuds |
| getAttribute() | Renvoie la valeur d'un attribut |
| getAttributeNS() | Renvoie la valeur d'un attribut (with a namespace) de (with a namespace) |
| getAttributeNode() | Retourne un noeud d'attribut comme un objet d'attributs |
| getAttributeNodeNS() | Retourne un noeud d'attribut (with a namespace) de (with a namespace) comme un objet d'attributs |
| getElementsByTagName() | Retourne un NodeList d'appariement des noeuds d'élément, et leurs enfants |
| getElementsByTagNameNS() | Retourne un NodeList d'appariement des noeuds d'élément (with a namespace) de (with a namespace) , et leurs enfants |
| getFeature(feature,version) | Renvoie un objet DOM qui implémente les API spécialisées de la fonctionnalité et de la version spécifiée |
| getUserData(key) | Renvoie l'objet associé à une touche sur un nœud. L'objet doit avoir été réglé sur ce noeud en appelant setUserData avec la même clé |
| hasAttribute() | Retourne si un élément a des attributs correspondant à un nom spécifié |
| hasAttributeNS() | Retourne si un élément a des attributs correspondant à un nom et espace de noms spécifié |
| hasAttributes() | Retourne si l'élément a des attributs |
| hasChildNodes() | Retourne si l'élément a des nœuds enfants |
| insertBefore() | Insère un nouveau nœud enfant devant un nœud enfant existant |
| isDefaultNamespace(URI) | Indique si le namespaceURI spécifié est la valeur par défaut |
| isEqualNode() | Vérifie si deux nœuds sont égaux |
| lookupNamespaceURI() | Renvoie l'URI d'espace correspondant à un préfixe spécifié |
| lookupPrefix() | Renvoie le préfixe correspondant à un espace de noms spécifié URI |
| normalize() | Met tous les nœuds de texte sous cet élément (including attributes) les "normal" (including attributes) dans un "normal" où seulement la structure (par exemple, des éléments, des commentaires, des instructions de traitement, les sections CDATA et références d'entité) sépare les nœuds de texte, à savoir, il n'y a ni nœuds de texte adjacents ni les nœuds de texte vides |
| removeAttribute() | Supprime un attribut spécifié |
| removeAttributeNS() | Supprime un attribut spécifié (with a namespace) de (with a namespace) |
| removeAttributeNode() | Supprime un noeud d'attribut spécifié |
| removeChild() | Supprime un nœud enfant |
| replaceChild() | Remplace un nœud enfant |
| setUserData(key,data,handler) | Associe un objet à une clé sur l'élément |
| setAttribute() | Ajoute un nouvel attribut |
| setAttributeNS() | Ajoute un nouvel attribut (with a namespace) de (with a namespace) |
| setAttributeNode() | Ajoute un nouveau noeud d'attribut |
| setAttributeNodeNS(attrnode) | Ajoute un nouveau noeud d'attribut (with a namespace) de (with a namespace) |
| setIdAttribute(name,isId) | Si la propriété isId de l'objet de l' attribut est true, cette méthode déclare l' specified attribut d'être un attribut ID déterminé par l' utilisateur |
| setIdAttributeNS(uri,name,isId) | Si la propriété isId de l'objet de l' attribut est true, cette méthode déclare l' specified attribut (with a namespace) de (with a namespace) pour être un attribut ID déterminé par l' utilisateur |
| setIdAttributeNode(idAttr,isId) | Si la propriété isId de l'objet de l' attribut est true, cette méthode déclare l' specified attribut d'être un attribut ID déterminé par l' utilisateur |