Obiekt Element XML DOM

Obiekt Element

Obiekt Element reprezentuje element dokumentu XML. Element może zawierać atrybuty, inne elementy lub tekst. Jeśli element zawiera tekst, jest on reprezentowany w węźle tekstowym.

Ważne:Tekst jest zawsze przechowywany w węzłach tekstowych. Jednym z częstych błędów w przetwarzaniu DOM jest nawigacja do węzła elementu i uważanie, że ten węzeł zawiera tekst. Jednak nawet najprostszy węzeł elementu ma węzeł tekstowy. Przykład, w <year>2005</year>, znajduje się węzeł elementu (year), a poniżej tego węzła znajduje się węzeł tekstowy zawierający tekst (2005).

Ponieważ obiekt Element jest również węzłem, może dziedziczyć atrybuty i metody obiektu Node.

Atrybuty obiektu Element

Atrybut Opis
Atrybuty Zwraca NamedNodeMap atrybutów elementu.
baseURI Zwraca absolutny punkt odniesienia URI elementu.
childNodes Zwraca NodeList potomków elementu.
firstChild Zwraca pierwszego potomka elementu.
lastChild Zwraca ostatniego potomka elementu.
localName Zwraca lokalną część nazwy elementu.
namespaceURI Zwraca URI przestrzeni nazw elementu.
nextSibling Zwraca węzeł, który jest bezpośrednio po tym elementie.
nodeName Zwraca nazwę węzła, w zależności od jego typu.
nodeType Zwraca typ węzła.
ownerDocument Zwraca element korzeniowy (obiekt dokumentu).
parentNode Zwraca rodzica elementu.
prefix Ustawia lub zwraca prefiks przestrzeni nazw elementu.
previousSibling Zwraca węzeł, który jest bezpośrednio przed tym elementem.
schemaTypeInfo Zwraca informacje o typie powiązanym z elementem.
tagName Zwraca nazwę elementu.
textContent Ustawia lub zwraca tekst zawartość elementu oraz jego potomków.

Metody obiektu Element

Metoda Opis
appendChild() Dodaje nowy potomek na koniec listy potomków węzła.
cloneNode() Klonuje węzeł.
compareDocumentPosition() Porównuje pozycję dokumentową dwóch węzłów.
getAttribute() Zwraca wartość atrybutu.
getAttributeNS() Zwraca wartość atrybutu (z przestrzenią nazw).
getAttributeNode() Zwraca węzeł atrybutu jako obiekt Attribute.
getAttributeNodeNS() Zwraca węzeł atrybutu (z przestrzenią nazw) jako obiekt Attribute.
getElementsByTagName() Zwraca NodeList elementów węzłów, które pasują do elementu oraz jego potomków.
getElementsByTagNameNS() Zwraca NodeList elementów węzłów, które pasują do elementu (z przestrzenią nazw) oraz jego potomków.
getFeature(feature,version) Zwraca obiekt DOM, który implementuje dedykowaną API dla określonych cech i wersji.
getUserData(key) Zwraca obiekt powiązany z kluczem na węźle. Należy najpierw ustawić obiekt na tym węźle, używając tej samej klucza do wywołania setUserData.
hasAttribute() Zwraca, czy element ma atrybut o określonej nazwie.
hasAttributeNS() Zwróć, czy element ma atrybut o podanym nazwie i przestrzeni nazw.
hasAttributes() Zwróć, czy element ma atrybuty.
hasChildNodes() Zwróć, czy element ma podwójne węzły.
insertBefore() Wstaw nowy węzeł podwójny przed istniejącym podwójnym węzłem.
isDefaultNamespace(URI) Zwróć, czy podany namespaceURI jest domyślny.
isEqualNode() Sprawdź, czy dwa węzły są równe.
lookupNamespaceURI() Zwróć URI przestrzeni nazw, który pasuje do podanego prefiksu.
lookupPrefix() Zwróć prefiks, który pasuje do podanego URI przestrzeni nazw.
normalize()

Metoda normalize() usuwa puste węzły tekstowe i łączy sąsiednie węzły tekstowe.

Normalizuj wszystkie węzły tekstowe pod elementem (w tym atrybuty), gdzie jedynie struktura (np. elementy, komentarze, instrukcje przetwarzania, sekcje CDATA i odwołania do encji) rozdziela węzły tekstowe.

To znaczy, że nie istnieją sąsiednie węzły tekstowe ani puste węzły tekstowe.
removeAttribute() Usuń określony atrybut.
removeAttributeNS() Usuń określony atrybut (z przestrzenią nazw).
removeAttributeNode() Usuń określony węzeł atrybutu.
removeChild() Usuń podwójny węzeł.
replaceChild() Zastąp podwójny węzeł.
setUserData(key,data,handler) Połącz obiekt z kluczem na elemencie.
setAttribute() Dodaj nowy atrybut.
setAttributeNS() Dodaj nowy atrybut (z przestrzenią nazw).
setAttributeNode() Dodaj nowy węzeł atrybutu.
setAttributeNodeNS(attrnode) Dodaj nowy węzeł atrybutu (z przestrzenią nazw).
setIdAttribute(name,isId) Jeśli atrybut obiektu Attribute ma atrybut isId ustawiony na true, ta metoda oznacza określony atrybut jako atrybut ID określony przez użytkownika.
setIdAttributeNS(uri,name,isId) Jeśli atrybut obiektu Attribute ma atrybut isId ustawiony na true, ta metoda oznacza określony atrybut (z przestrzenią nazw) jako atrybut ID określony przez użytkownika.
setIdAttributeNode(idAttr,isId) Jeśli atrybut obiektu Attribute ma atrybut isId ustawiony na true, ta metoda oznacza określony atrybut jako atrybut ID określony przez użytkownika.