O objeto Document representa todo o documento XML.
O objeto de documento XML
O objeto Document é a raiz de uma árvore de documento XML, e nos dá o acesso principal para os dados do documento.
Desde nós elemento, nós de texto, comentários, instruções de processamento, etc, não podem existir fora do documento, o objeto Document também contém métodos para criar esses objetos. Os objetos Node tem uma propriedade ownerDocument que os associa com o Documento de onde eles foram criados.
Propriedades do objeto de documento
| Propriedade | Descrição |
|---|---|
| childNodes | Retorna um NodeList de nós filho para o documento |
| doctype | Retorna a Declaração Tipo de Documento associado ao documento |
| documentElement | Retorna o nó raiz do documento |
| documentURI | Define ou retorna a localização do documento |
| domConfig | Retorna a configuração usada quando normalizeDocument() é invocado |
| firstChild | Retorna o primeiro nó filho do documento |
| implementation | Retorna o objeto DOMImplementation que lida com este documento |
| inputEncoding | Retorna a codificação usada para o documento (when parsing) |
| lastChild | Retorna o último nó filho do documento |
| nodeName | Retorna o nome de um nó (depending on its type) |
| nodeType | Retorna o tipo de nó de um nó |
| nodeValue | Define ou retorna o valor de um nó (depending on its type) |
| xmlEncoding | Retorna a codificação XML do documento |
| xmlStandalone | Define ou retorna se o documento é autônomo |
| xmlVersion | Define ou retorna a versão XML do documento |
Métodos de objeto de documento
| Método | Descrição |
|---|---|
| adoptNode(sourcenode) | Adota um nó de outro documento com este documento, e retorna o nó adotada |
| createAttribute(name) | Cria um nó de atributo com o nome especificado, e retorna o novo objeto Attr |
| createAttributeNS(uri,name) | Cria um nó de atributo com o nome e namespace especificado, e retorna o novo objeto Attr |
| createCDATASection() | Cria um nó seção CDATA |
| createComment() | Cria um comentário nó |
| createDocumentFragment() | Cria um objeto DocumentFragment vazio, e devolve-lo |
| createElement() | Cria um nó de elemento |
| createElementNS() | Cria um nó elemento com um espaço para nome especificado |
| createEntityReference(name) | Cria um objeto EntityReference, e devolve-lo |
| createProcessingInstruction(target,data) | Cria um objeto ProcessingInstruction, e devolve-lo |
| createTextNode() | Cria um nó de texto |
| getElementById(id) | Retorna o elemento que tem um atributo ID com o valor dado. Se tal elemento não existe, ele retorna null |
| getElementsByTagName() | Retorna um NodeList de todos os elementos com um nome especificado |
| getElementsByTagNameNS() | Retorna um NodeList de todos os elementos com um nome e namespace especificado |
| importNode(nodetoimport,deep) | Importa um nó a partir de outro documento para este documento. Este método cria uma nova cópia do nó de origem. Se o parâmetro de profundidade é definido como verdadeiro, ele importa todos os filhos do nó especificado. Se definido como falso, importa apenas o próprio nó. Este método retorna o nó importado |
| normalizeDocument() | |
| renameNode() | Renomeia um nó de elemento ou atributo |
Propriedades do objeto DocumentType
Cada documento tem um atributo DOCTYPE que cujo valor é nulo ou um objeto DocumentType.
O objecto DocumentType fornece uma interface para as entidades definidas para um documento XML.
| Propriedade | Descrição |
|---|---|
| name | Retorna o nome do DTD |
| publicId | Retorna o identificador público do DTD |
| systemId | Retorna o identificador do sistema do DTD externa |
Métodos de objeto DocumentImplementation
O objeto DOMImplementation executa operações que são independentes de qualquer caso particular do modelo de objeto de documento.
| Método | Descrição |
|---|---|
| createDocument(nsURI, name, doctype) | Cria um novo objeto DOM Documento do doctype especificado |
| createDocumentType(name, pubId, systemId) | Cria um nó DocumentType vazia |
| getFeature(feature, version) | Retorna um objeto que implementa as APIs do recurso especificado e versão, se o é qualquer |
| hasFeature(feature, version) | Verifica se a implementação DOM implementa um recurso específico e versão |
Propriedades do objeto ProcessingInstruction
O objecto ProcessingInstruction representa uma instrução de processamento.
Uma instrução de processamento é utilizado como uma forma de manter as informações específicas do processador no texto do documento XML.
| Propriedade | Descrição |
|---|---|
| data | Define ou retorna o conteúdo desta instrução de processamento |
| target | Retorna o alvo desta instrução de processamento |