XML DOM Element-objekti

Element-objekti

Element-objekti edustaa XML-dokumentin elementtiä. Elementti voi sisältää ominaisuuksia, muita elementtejä tai tekstiä. Jos elementissä on tekstiä, se esitetään tekstisolmussa.

Tärkeää:Teksti tallennetaan aina tekstisolmussa. Yksi yleisimmistä virheistä DOM-käsittelyssä on navigoida elementtisolmun suuntaan ja uskoa, että tämä solmu sisältää tekstiä. Vaikka jopa kaikkein yksinkertaisimmassa elementtisolmussa on tekstisolmu. Esimerkiksi <year>2005</year> -elementissä on elementtisolmu (year), ja tämän solmun alla on tekstisolmu, joka sisältää tekstin (2005).

Koska Element-objekti on myös solmu, se voi peri Node-objektin ominaisuudet ja menetelmät.

Element-objektin ominaisuudet

Ominaisuudet Kuvaus
attributes Palauttaa elementin ominaisuuden nimettyä NodeMap:ia.
baseURI Palauttaa elementin absoluuttisen referenss URI:n.
childNodes Palauttaa elementin lapsisolmujen NodeListin.
firstChild Palauttaa elementin ensimmäisen lapsisolmun.
lastChild Palauttaa elementin viimeisen lapsisolmun.
localName Palauttaa elementin nimen paikallisen osan.
namespaceURI Palauttaa elementin nimespacen URI:n.
nextSibling Palauttaa solmun, joka sijaitsee elementin jälkeen.
nodeName Palauttaa solmun nimen, riippuen sen tyyppiksestä.
nodeType Palauttaa solmun tyyppin.
ownerDocument Palauttaa elementin juuri-elementin (dokumenttiosoite).
parentNode Palauttaa elementin emo-solmun.
prefix Asettaa tai palauttaa elementin nimespacen etuliitteen.
previousSibling Palauttaa solmun, joka sijaitsee elementin edellä.
schemaTypeInfo Palauttaa elementtiin liittyvän tietotyyppitiedon.
tagName Palauttaa elementin nimen.
textContent Asettaa tai palauttaa elementin ja sen jälkeläisten tekstisisällön.

Element-objektin metodit

Metodi Kuvaus
appendChild() Lisää uuden lapsisolmun solmun lapsisolmujen luetteloon loppuun.
cloneNode() Kloonaa solmun.
compareDocumentPosition() Vertaile kahden solmun asiakirja-asemaa.
getAttribute() Palauttaa attribuutin arvon.
getAttributeNS() Palauttaa attribuutin arvon (nimiavaruus mukana).
getAttributeNode() Palauttaa attribuuttinode attribuuttiobjektina.
getAttributeNodeNS() Palauttaa attribuuttinode (nimiavaruus mukana) attribuuttiobjektina.
getElementsByTagName() Palauttaa NodeList-objektin, joka sisältää vastaanotetut elementtinode ja niiden jälkeläiset.
getElementsByTagNameNS() Palauttaa NodeList-objektin, joka sisältää vastaanotetut elementtinode ja niiden jälkeläiset (nimiavaruus mukana).
getFeature(feature,version) Palauttaa DOM-objektin, joka toteuttaa määritetyn ominaisuuden ja version erityisen API:n.
getUserData(key) Palauttaa objektin, joka liittyy solmun avaimen kanssa. On ensin asetettava objekti tähän solmuun käyttämällä setUserData-metodia.
hasAttribute() Palauttaa, onko elementillä määritetty ominaisuus, joka vastaa annettua nimeä.
hasAttributeNS() Palauta, onko elementillä ominaisuus, joka vastaa määritettyä nimeä ja nimenomaista URI:ta.
hasAttributes() Palauta, onko elementillä ominaisuuksia.
hasChildNodes() Palauta, onko elementillä lapsisolmuja.
insertBefore() Lisää uusi lapsisolmu olemassa olevien lapsisolmujen eteen.
isDefaultNamespace(URI) Palauta onko määritetty namespaceURI oletusarvo.
isEqualNode() Tarkista, ovatko kaksi solmua yhtä.
lookupNamespaceURI() Palauta nimenomainen URI, joka vastaa määritettyä etuliitettä.
lookupPrefix() Palauta etuliite, joka vastaa määritettyä nimenomaista URI:ta.
normalize()

normalize()-menetelmä poistaa tyhjät tekstisolmut ja yhdistää läheiset tekstisolmut.

Täysin normalisoi elementin alaiset kaikki tekstisolmut (mukaan lukien ominaisuudet), joissa vain rakenne (esim. elementit, kommentit, käsittelyohjeet, CDATA-osat ja entiteettireferenssit) erottaa tekstisolmut.

Toisin sanoen, ei ole läheisiä tekstisolmuja eikä tyhjiä tekstisolmuja.

removeAttribute() Poista määritetty ominaisuus.
removeAttributeNS() Poista määritetty ominaisuus (nimellisellä alueella).
removeAttributeNode() Poista määritetty ominaisuus solmu.
removeChild() Poista alisolmu.
replaceChild() Korvaa alisolmu.
setUserData(key,data,handler) Yhdistä objekti elementin avaimen kanssa.
setAttribute() Lisää uusi ominaisuus.
setAttributeNS() Lisää uusi ominaisuus (nimellisellä alueella).
setAttributeNode() Lisää uusi ominaisuus solmu.
setAttributeNodeNS(attrnode) Lisää uusi ominaisuus solmu (nimellisellä alueella).
setIdAttribute(name,isId) Jos Attribute-objektin isId-ominaisuus on totta, tämä metodi määrittää määritetyn ominaisuuden käyttäjän määrittämäksi ID-ominaisuudeksi.
setIdAttributeNS(uri,name,isId) Jos Attribute-objektin isId-ominaisuus on totta, tämä metodi määrittää määritetyn ominaisuuden (nimellisellä alueella) käyttäjän määrittämäksi ID-ominaisuudeksi.
setIdAttributeNode(idAttr,isId) Jos Attribute-objektin isId-ominaisuus on totta, tämä metodi määrittää määritetyn ominaisuuden käyttäjän määrittämäksi ID-ominaisuudeksi.