XML DOM Element-objekti
- Edellinen sivu DOM Dokumentti
- Seuraava sivu DOM Attr
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. |
- Edellinen sivu DOM Dokumentti
- Seuraava sivu DOM Attr