L'objet Document représente le document XML entier.
L'objet de document XML
L'objet Document est la racine d'un arbre de document XML, et nous donne l'accès principal aux données du document.
Depuis les noeuds d'élément, les nœuds de texte, les commentaires, les instructions de traitement, etc. ne peuvent exister en dehors du document, l'objet Document contient également des méthodes pour créer ces objets. Les objets Node ont une propriété ownerDocument qui les associe au document où ils ont été créés.
Propriétés de l'objet de document
| Propriété | La description |
|---|---|
| childNodes | Renvoie un NodeList de nœuds enfants pour le document |
| doctype | Renvoie la déclaration de type de document associé au document |
| documentElement | Renvoie le nœud racine du document |
| documentURI | Définit ou retourne l'emplacement du document |
| domConfig | Renvoie la configuration utilisée lorsque normalizeDocument() est invoquée |
| firstChild | Renvoie le premier noeud du document enfant |
| implementation | Renvoie l'objet DOMImplementation qui gère ce document |
| inputEncoding | Renvoie l'encodage utilisé pour le document (when parsing) de l' (when parsing) |
| lastChild | Renvoie le dernier noeud du document de l'enfant |
| nodeName | Renvoie le nom d'un noeud (depending on its type) en (depending on its type) |
| nodeType | Retourne le type d'un noeud de noeud |
| nodeValue | Définit ou retourne la valeur d'un noeud (depending on its type) en (depending on its type) |
| xmlEncoding | Renvoie l'encodage XML du document |
| xmlStandalone | Définit ou retourne si le document est autonome |
| xmlVersion | Définit ou renvoie la version XML du document |
Méthodes de l'objet de document
| méthode | La description |
|---|---|
| adoptNode(sourcenode) | Adopte un noeud d'un autre document à ce document, et renvoie le noeud adopté |
| createAttribute(name) | Crée un nœud d'attribut avec le nom spécifié, et retourne le nouvel objet Attr |
| createAttributeNS(uri,name) | Crée un nœud d'attribut avec le nom et espace de noms spécifié, et retourne le nouvel objet Attr |
| createCDATASection() | Crée une section noeud CDATA |
| createComment() | Crée un noeud de commentaire |
| createDocumentFragment() | Crée un objet DocumentFragment vide, et le renvoie |
| createElement() | Crée un nœud d'élément |
| createElementNS() | Crée un noeud avec un espace de noms spécifié |
| createEntityReference(name) | Crée un objet EntityReference, et le renvoie |
| createProcessingInstruction(target,data) | Crée un objet ProcessingInstruction, et le renvoie |
| createTextNode() | Crée un nœud de texte |
| getElementById(id) | Renvoie l'élément qui a un attribut ID avec la valeur donnée. Si un tel élément existe, elle renvoie null |
| getElementsByTagName() | Renvoie un NodeList de tous les éléments avec un nom spécifié |
| getElementsByTagNameNS() | Renvoie un NodeList de tous les éléments avec un nom et espace de noms spécifié |
| importNode(nodetoimport,deep) | Importe un noeud à partir d'un autre document à ce document. Ce procédé crée une nouvelle copie du noeud source. Si le paramètre deep est défini sur true, il importe que tous les enfants du noeud spécifié. Si la valeur false, il importe que le nœud lui-même. Cette méthode renvoie le noeud importé |
| normalizeDocument() | |
| renameNode() | Renomme un noeud d'élément ou d'un attribut |
DocumentType Propriétés de l'objet
Chaque document a un attribut DOCTYPE qui dont la valeur est null ou un objet DocumentType.
L'objet DocumentType fournit une interface pour les entités définies pour un document XML.
| Propriété | La description |
|---|---|
| name | Retourne le nom de la DTD |
| publicId | Retourne l'identifiant public de la DTD |
| systemId | Renvoie l'identifiant du système de la DTD externe |
DocumentImplementation méthodes d'objets
L'objet DOMImplementation effectue des opérations qui sont indépendantes de toute instance particulière du modèle objet de document.
| méthode | La description |
|---|---|
| createDocument(nsURI, name, doctype) | Crée un nouvel objet DOM Document du doctype spécifié |
| createDocumentType(name, pubId, systemId) | Crée un nœud DocumentType vide |
| getFeature(feature, version) | Retourne un objet qui implémente les API de la fonction et de la version spécifiée, si l'est tout |
| hasFeature(feature, version) | Vérifie si l'implémentation DOM implémente une fonctionnalité et version spécifique |
ProcessingInstruction Propriétés de l'objet
L'objet ProcessingInstruction représente une instruction de traitement.
Une instruction de traitement est utilisée comme un moyen de garder l'information spécifique au processeur dans le texte du document XML.
| Propriété | La description |
|---|---|
| data | Définit ou renvoie le contenu de cette instruction de traitement |
| target | Renvoie la cible de cette instruction de traitement |