El objeto del documento representa la totalidad del documento XML.
El objeto del documento XML
El objeto del documento es la raíz de un árbol de documentos XML, y nos da el acceso primario a los datos del documento.
Puesto que los nodos de elementos, los nodos de texto, comentarios, instrucciones de procesamiento, etc., no pueden existir fuera del documento, el objeto del documento también contiene métodos para crear estos objetos. Los objetos Node tienen una propiedad ownerDocument que los asocia con el documento en el que fueron creados.
Propiedades de objetos de documento
| Propiedad | Descripción |
|---|---|
| childNodes | Devuelve un NodeList de los nodos secundarios para el documento |
| doctype | Devuelve la Declaración de tipo de documento asociado con el documento |
| documentElement | Devuelve el nodo raíz del documento |
| documentURI | Establece o devuelve la ubicación del documento |
| domConfig | Devuelve la configuración utilizada cuando normalizeDocument() se invoca |
| firstChild | Devuelve el primer nodo hijo del documento |
| implementation | Devuelve el objeto DOMImplementation que se encarga de este documento |
| inputEncoding | Devuelve la codificación utilizada para el documento (when parsing) |
| lastChild | Devuelve el último nodo hijo del documento |
| nodeName | Devuelve el nombre de un nodo (depending on its type) |
| nodeType | Devuelve el tipo de nodo de un nodo |
| nodeValue | Establece o devuelve el valor de un nodo (depending on its type) |
| xmlEncoding | Devuelve la codificación XML del documento |
| xmlStandalone | Establece o devuelve si el documento es independiente |
| xmlVersion | Establece o devuelve la versión XML del documento |
Métodos de objetos de documento
| Método | Descripción |
|---|---|
| adoptNode(sourcenode) | Adopta un nodo de otro documento a este documento, y devuelve el nodo adoptado |
| createAttribute(name) | Crea un nodo de atributo con el nombre especificado y devuelve el nuevo objeto Attr |
| createAttributeNS(uri,name) | Crea un nodo atributo con el nombre y el espacio de nombres especificado y devuelve el nuevo objeto Attr |
| createCDATASection() | Crea un nodo de la sección CDATA |
| createComment() | Crea un nodo de comentario |
| createDocumentFragment() | Crea un objeto de DocumentFragment vacía, y lo devuelve |
| createElement() | Crea un nodo de elemento |
| createElementNS() | Crea un nodo de elemento con un espacio de nombres especificado |
| createEntityReference(name) | Crea un objeto de EntityReference, y lo devuelve |
| createProcessingInstruction(target,data) | Crea un objeto ProcessingInstruction, y lo devuelve |
| createTextNode() | Crea un nodo de texto |
| getElementById(id) | Devuelve el elemento que tiene un atributo ID con el valor dado. Si no existe tal elemento, devuelve null |
| getElementsByTagName() | Devuelve un NodeList de todos los elementos con un nombre especificado |
| getElementsByTagNameNS() | Devuelve un NodeList de todos los elementos con un nombre y espacio de nombres especificado |
| importNode(nodetoimport,deep) | Importa un nodo de otro documento a este documento. Este método crea una nueva copia del nodo de origen. Si el parámetro de profundidad se establece en true, importa todos los hijos del nodo especificado. Si se establece en false, importa sólo el propio nodo. Este método devuelve el nodo importado |
| normalizeDocument() | |
| renameNode() | Cambia el nombre de un nodo elemento o atributo |
Propiedades del objeto DocumentType
Cada documento tiene un atributo que DOCTYPE cuyo valor es null o un objeto DocumentType.
El objeto DocumentType proporciona una interfaz para las entidades definidas para un documento XML.
| Propiedad | Descripción |
|---|---|
| name | Devuelve el nombre de la DTD |
| publicId | Devuelve el identificador público de la DTD |
| systemId | Devuelve el identificador del sistema de la DTD externa |
Métodos del objeto DocumentImplementation
El objeto DOMImplementation realiza las operaciones que son independientes de cualquier caso particular del modelo de objetos de documento.
| Método | Descripción |
|---|---|
| createDocument(nsURI, name, doctype) | Crea un nuevo objeto DOM de documentos del tipo de documento especificado |
| createDocumentType(name, pubId, systemId) | Crea un nodo DocumentType vacía |
| getFeature(feature, version) | Devuelve un objeto que implementa las API de la función y la versión especificada, si el es cualquier |
| hasFeature(feature, version) | Comprueba si la implementación DOM implementa una característica específica y la versión |
Propiedades del objeto ProcessingInstruction
El objeto ProcessingInstruction representa una instrucción de procesamiento.
Una instrucción de procesamiento se utiliza como una manera de mantener la información específica del procesador en el texto del documento XML.
| Propiedad | Descripción |
|---|---|
| data | Establece o devuelve el contenido de esta instrucción de procesamiento |
| target | Devuelve el objetivo de esta instrucción de procesamiento |