XML DOM - Document-objekti

Document-objekti edustaa koko XML-dokumenttia.

XML-dokumenttiobjekti

Document-objekti on XML-dokumenttipuun juuri, ja se tarjoaa meille pääasiallisen pääsyn dokumenttitietoihin.

Koska elementinodot, tekstinodeja, kommentteja, prosessointikomentoja ja muita ei voi olla dokumentin ulkopuolella, Document-objekti sisältää myös menetelmiä näiden objektien luomiseksi. Node-objekti sisältää omistusdokumentti-ominaisuuden, joka yhdistää ne luoneeseen Document-objektiin.

Document-objektin ominaisuudet

Ominaisuudet Kuvaus
childNodes Palauttaa asiakirjan lapsinodotteiden NodeList.
doctype Palauttaa asiakirjaan liittyvän dokumentityypin.
documentElement Palauttaa asiakirjan juurinodotteen.
documentURI Asettaa tai palauttaa asiakirjan sijainnin.
domConfig Palauttaa konfiguraation, jota käytettiin normalizeDocument()-kutsussa.
firstChild Palauttaa asiakirjan ensimmäisen lapsinodotteen.
implementation Palauttaa tämän asiakirjan käytetyn DOMImplementation-objektin.
inputEncoding Palauttaa asiakirjan käytetyn koodauksen tavan (selvittäessäsi sitä).
lastChild Palauta dokumentin viimeinen lapsisolmu.
nodeName Palauta solmun nimi (riippuen sen tyypistä).
nodeType Palauta solmun solmutyyppi.
nodeValue Aseta tai palauta solmun arvo (riippuen sen tyypistä).
xmlEncoding Palauta dokumentin XML-koodaus.
xmlStandalone Aseta tai palauta onko dokumentti itsenäinen.
xmlVersion Aseta tai palauta dokumentin XML-versio.

Document-objektin metodit

Menetelmä Kuvaus
adoptNode() Ota toisen dokumentin solmu vastaan tähän dokumenttiin ja palauta vastaanotettu solmu.
createAttribute() Luo ominaisuus, jolla on määritelty nimi ja palauta uusi Attr-objekti.
createAttributeNS() Luo ominaisuus, jolla on määritelty nimi ja nimiavaruus, ja palauta uusi Attr-objekti.
createCDATASection() Luo CDATA-sektio-solmu.
createComment() Luo kommenttisolmu.
createDocumentFragment() Luo tyhjä DocumentFragment-objekti ja palauta se.
createElement() Luo elementti.
createElementNS() Luo elementti, jolla on määritelty nimi ja nimiavaruus.
createEntityReference() Luo EntityReference-objekti ja palauta tämä objekti.
createProcessingInstruction() Luo ProcessingInstruction-objekti ja palauta tämä objekti.
createTextNode() Luo tekstisolmu.
getElementById() Palauta elementti, jolla on annettu arvon omaava id-ominaisuus.
getElementsByTagName() Palauta NodeList, joka sisältää kaikki nimeltään määritellyt elementit.
getElementsByTagNameNS() Palauta NodeList, joka sisältää kaikki nimeltään määritellyt ja määritellyssä tilassa olevat elementit.
importNode() Tuo solmu toisesta dokumentista tähän dokumenttiin.
normalizeDocument()
renameNode() Nimeä uudelleen elementti- tai ominaisuusnode.

DocumentType-objektin ominaisuudet

Jokaisella dokumentilla on DOCTYPE-ominaisuus, jonka arvo on null tai DocumentType-objekti.

DocumentType-objekti tarjoaa rajapinnan XML-dokumentin määrittämille entiteeteille.

Ominaisuudet Kuvaus
name Palauttaa DTD:n nimen.
publicId Palauttaa DTD:n julkisen identifikaattorin.
systemId Palauttaa ulkoisen DTD:n järjestelmäidentifikaattorin.

DocumentImplementation-objektin menetelmät

DOMImplementation-objekti suorittaa riippumattomia dokumentiomallia koskevia toimintoja.

Menetelmä Kuvaus
createDocument() Luo uusi DOM Document-objekti määritetyn dokumentityypin kanssa.
createDocumentType() Luo tyhjä DocumentType-solmu.
getFeature() Palauttaa objektin, joka toteuttaa määritetyn ominaisuuden ja version API (jos sellainen on olemassa).
hasFeature() Tarkista, onko DOM-toteutus toteuttanut tietyn ominaisuuden ja version.

ProcessingInstruction-objektin ominaisuudet

ProcessingInstruction-objekti edustaa käsittelyohjetta.

Käsittelyohje on käytetty menetelmä XML-dokumentin tekstissä säilytettävän käsittelytietojen tallentamiseksi.

Ominaisuudet Kuvaus
data Aseta tai palauta tavoitetun ohjeen sisältö.
target Palauta tavoitetun ohjeen kohde.