Przedmiotem Element
Przedmiotem Element reprezentuje element w dokumencie XML. Elementy mogą zawierać atrybuty, inne elementy lub tekst. Jeśli element zawiera tekst, tekst jest reprezentowana w text-węzła.
IMPORTANT! Tekst jest zawsze przechowywany w węzłach tekstowych. Częstym błędem w przetwarzaniu DOM jest przejść do węzła elementu i oczekiwać, że zawierają tekst. Jednak nawet najprostsze węzeł element posiada węzeł tekstowy pod nią. Na przykład, w <year>2005</year> istnieje wierzchołkiem elementu (year) , a węzłem tekst pod nią, która zawiera tekstu (2005) .
Ponieważ obiekt Element jest również węzeł, dziedziczy właściwości i metody obiektu węzła.
Właściwości obiektu Element
| Nieruchomość | Opis |
|---|---|
| attributes | Zwraca NamedNodeMap atrybutów dla elementu |
| baseURI | Zwraca absolutne podstawy URI elementu |
| childNodes | Zwraca NodeList węzłów potomnych dla elementu |
| firstChild | Zwraca pierwsze dziecko elementu |
| lastChild | Zwraca ostatnie dziecko elementu |
| localName | Zwraca lokalny część nazwy elementu |
| namespaceURI | Zwraca URI przestrzeni nazw elementu |
| nextSibling | Zwraca węzeł bezpośrednio po elemencie |
| nodeName | Zwraca nazwę węzła, w zależności od jego typu |
| nodeType | Zwraca typu węzła |
| ownerDocument | Zwraca element główny (document object) dla elementu |
| parentNode | Zwraca węzeł nadrzędny element |
| prefix | Ustawia lub zwraca prefiks przestrzeni nazw elementu |
| previousSibling | Zwraca węzeł bezpośrednio przed elementem |
| schemaTypeInfo | Zwraca typ informacji związanych z elementem |
| tagName | Zwraca nazwę elementu |
| textContent | Ustawia lub zwraca zawartość tekstową elementu i jego potomków |
Element Metody obiektowe
| metoda | Opis |
|---|---|
| appendChild() | Dodanie nowego węzła potomnego do końca listy dzieci węzła |
| cloneNode() | Klonów węzła |
| compareDocumentPosition() | Porównuje pozycję dokumentu z dwoma węzłami |
| getAttribute() | Zwraca wartość atrybutu |
| getAttributeNS() | Zwraca wartość atrybutu (with a namespace) |
| getAttributeNode() | Zwraca węzeł atrybutu jako obiekt atrybutu |
| getAttributeNodeNS() | Zwraca węzeł atrybutu (with a namespace) jako obiekt atrybutu |
| getElementsByTagName() | Zwraca NodeList dopasowanie węzłów elementu i ich dzieci |
| getElementsByTagNameNS() | Zwraca NodeList pasujące węzły elementów (with a namespace) oraz ich dzieci |
| getFeature(feature,version) | Zwraca obiekt DOM, który implementuje API specjalistycznych o określonej funkcji i wersji |
| getUserData(key) | Zwraca obiekt skojarzony z kluczem na tym węźle. Obiekt musi najpierw zostały ustawione na tym węźle, wywołując setUserData z tym samym kluczem |
| hasAttribute() | Zwraca czy element posiada jakiekolwiek atrybuty odpowiadające określonej nazwy |
| hasAttributeNS() | Zwraca czy dany element ma żadnych atrybutów pasujących do podanej nazwy i przestrzeni nazw |
| hasAttributes() | Zwraca czy element posiada jakiekolwiek atrybuty |
| hasChildNodes() | Zwraca czy element ma żadnych węzłów potomnych |
| insertBefore() | Wstawia przed istniejącego węzła potomnego nowy węzeł podrzędny |
| isDefaultNamespace(URI) | Zwraca czy podany namespaceURI jest domyślnym |
| isEqualNode() | Sprawdza, czy dwa węzły są równe |
| lookupNamespaceURI() | Zwraca URI przestrzeni nazw dopasowania określony prefiks |
| lookupPrefix() | Zwraca prefiks dopasowanie określonej przestrzeni nazw URI |
| normalize() | Umieszcza wszystkie węzły tekstowe pod spodem tego elementu (including attributes) do "normal" postaci, gdzie tylko struktura (np elementy, komentarze, instrukcje przetwarzania, sekcje CDATA i referencje podmiot) oddziela węzły tekstowe, czyli nie ma ani sąsiednie węzły tekstowe, ani puste węzły tekstowe |
| removeAttribute() | Usuwa określony atrybut |
| removeAttributeNS() | Usuwa określony atrybut (with a namespace) |
| removeAttributeNode() | Usuwa określony węzeł atrybutu |
| removeChild() | Usuwa węzeł potomny |
| replaceChild() | Zastępuje węzeł podrzędny |
| setUserData(key,data,handler) | Przypisuje obiekt do klawisza na elemencie |
| setAttribute() | Dodaje nowy atrybut |
| setAttributeNS() | Dodaje nowy atrybut (with a namespace) |
| setAttributeNode() | Dodaje nowy węzeł atrybutu |
| setAttributeNodeNS(attrnode) | Dodaje nowy węzeł atrybutu (with a namespace) |
| setIdAttribute(name,isId) | Jeśli właściwość isId obiektu atrybut jest prawdziwa, ta metoda deklaruje specified atrybut być atrybutem ID użytkownika określony |
| setIdAttributeNS(uri,name,isId) | Jeśli właściwość isId obiektu atrybut jest prawdziwa, ta metoda deklaruje specified atrybutu (with a namespace) , aby być atrybutem ID użytkownika określony |
| setIdAttributeNode(idAttr,isId) | Jeśli właściwość isId obiektu atrybut jest prawdziwa, ta metoda deklaruje specified atrybut być atrybutem ID użytkownika określony |