L'oggetto Document rappresenta l'intero documento XML.
L'oggetto documento XML
L'oggetto Document è la radice di un albero di documento XML, e ci dà l'accesso principale per i dati del documento.
Dal momento che i nodi di elementi, nodi di testo, commenti, istruzioni di elaborazione, ecc non può esistere al di fuori del documento, l'oggetto documento contiene inoltre metodi per creare questi oggetti. Gli oggetti Node hanno una proprietà ownerDocument che li associa con il documento in cui sono stati creati.
Proprietà oggetto del documento
| Proprietà | Descrizione |
|---|---|
| childNodes | Restituisce un NodeList di nodi figlio per il documento |
| doctype | Restituisce la dichiarazione del tipo di documento associato al documento |
| documentElement | Restituisce il nodo radice del documento |
| documentURI | Imposta o restituisce la posizione del documento |
| domConfig | Restituisce la configurazione utilizzata quando normalizeDocument() viene richiamato |
| firstChild | Restituisce il primo nodo figlio del documento |
| implementation | Restituisce l'oggetto DOMImplementation che gestisce questo documento |
| inputEncoding | Restituisce la codifica utilizzata per il documento (when parsing) |
| lastChild | Restituisce l'ultimo nodo figlio del documento |
| nodeName | Restituisce il nome di un nodo (depending on its type) |
| nodeType | Restituisce il tipo di nodo di un nodo |
| nodeValue | Imposta o restituisce il valore di un nodo (depending on its type) |
| xmlEncoding | Restituisce la codifica XML del documento |
| xmlStandalone | Imposta o restituisce se il documento è autonomo |
| xmlVersion | Imposta o restituisce la versione XML del documento |
Metodi Document Object
| metodo | Descrizione |
|---|---|
| adoptNode(sourcenode) | Adotta un nodo da un altro documento di questo documento, e restituisce il nodo adottato |
| createAttribute(name) | Crea un nodo attributo con il nome specificato, e restituisce il nuovo oggetto Attr |
| createAttributeNS(uri,name) | Crea un nodo attributo con il nome e spazio dei nomi specificato, e restituisce il nuovo oggetto Attr |
| createCDATASection() | Crea un nodo di sezione CDATA |
| createComment() | Crea un nodo commento |
| createDocumentFragment() | Crea un oggetto DocumentFragment vuoto, e lo restituisce |
| createElement() | Crea un nodo elemento |
| createElementNS() | Crea un nodo elemento con uno spazio dei nomi specificato |
| createEntityReference(name) | Crea un oggetto EntityReference, e lo restituisce |
| createProcessingInstruction(target,data) | Crea un oggetto ProcessingInstruction, e lo restituisce |
| createTextNode() | Crea un nodo di testo |
| getElementById(id) | Restituisce l'elemento che ha un attributo ID con il valore dato. Se tale elemento non esiste, restituisce null |
| getElementsByTagName() | Restituisce un NodeList di tutti gli elementi con un nome specificato |
| getElementsByTagNameNS() | Restituisce un NodeList di tutti gli elementi con un nome e spazio dei nomi specificato |
| importNode(nodetoimport,deep) | Importa un nodo da un altro documento a questo documento. Questo metodo crea una nuova copia del nodo sorgente. Se il parametro profondità è impostato su true, importa tutti i bambini del nodo specificato. Se impostato su false, importa solo il nodo stesso. Questo metodo restituisce il nodo importato |
| normalizeDocument() | |
| renameNode() | Rinomina un nodo di elemento o un attributo |
Proprietà oggetto DocumentType
Ogni documento ha un attributo DOCTYPE che il cui valore è null o un oggetto DocumentType.
L'oggetto DocumentType fornisce un'interfaccia per le entità definite per un documento XML.
| Proprietà | Descrizione |
|---|---|
| name | Restituisce il nome del DTD |
| publicId | Restituisce l'identificatore pubblico del DTD |
| systemId | Restituisce l'identificatore di sistema del DTD esterno |
Metodi dell'oggetto DocumentImplementation
L'oggetto DOMImplementation esegue le operazioni che sono indipendenti da qualsiasi particolare istanza del modello a oggetti documento.
| metodo | Descrizione |
|---|---|
| createDocument(nsURI, name, doctype) | Crea un nuovo oggetto DOM Documento del DOCTYPE specificata |
| createDocumentType(name, pubId, systemId) | Crea un nodo DocumentType vuoto |
| getFeature(feature, version) | Restituisce un oggetto che implementa le API della funzione e versione specificata, se è un qualsiasi |
| hasFeature(feature, version) | Verifica se l'implementazione DOM una caratteristica e specifica versione |
Proprietà oggetto ProcessingInstruction
L'oggetto ProcessingInstruction rappresenta una istruzione di elaborazione.
Una istruzione di elaborazione è usato come un modo per mantenere informazioni specifiche processore nel testo del documento XML.
| Proprietà | Descrizione |
|---|---|
| data | Imposta o restituisce il contenuto di questa istruzione di elaborazione |
| target | Restituisce il target di questa istruzione di elaborazione |