XML DOM - ElementObjekt
Element-Objekt
Das Element-Objekt repräsentiert ein Element in einem XML-Dokument. Elemente können Attribute, andere Elemente oder Text enthalten. Wenn ein Element Text enthält, wird dieser Text in einem Textknoten dargestellt.
Wichtig:Text wird immer in Textknoten gespeichert. Ein häufiger Fehler bei der DOM-Verarbeitung besteht darin, zu einem Elementknoten zu navigieren und anzunehmen, dass dieser Knoten Text enthält. Selbst der einfachste Elementknoten hat jedoch einen Textknoten unter ihm. Zum Beispiel gibt es in <year>2005</year> einen Elementknoten (year), und unter diesem Knoten gibt es einen Textknoten, der den Text (2005) enthält.
Da das Element-Objekt ebenfalls ein Knoten ist, kann es die Eigenschaften und Methoden des Node-Objekts erben.
Eigenschaften des Element-Objekts
| Eigenschaft | Beschreibung |
|---|---|
| attributes | Gibt eine NamedNodeMap der Attribute des Elements zurück. |
| baseURI | Gibt die absolute Basis-URI des Elements zurück. |
| childNodes | Gibt eine NodeList der untergeordneten Knoten des Elements zurück. |
| firstChild | Gibt den ersten untergeordneten Knoten des Elements zurück. |
| lastChild | Gibt den letzten untergeordneten Knoten des Elements zurück. |
| localName | Gibt den lokalen Teil des Namens des Elements zurück. |
| namespaceURI | Gibt die Namespace-URI des Elements zurück. |
| nextSibling | Gibt den Knoten zurück, der unmittelbar auf das Element folgt. |
| nodeName | Gibt den Namen des Knotens zurück, abhängig von seinem Typ. |
| nodeType | Gibt den Typ des Knotens zurück. |
| ownerDocument | Gibt das Wurzelelement (Dokumentobjekt) zurück, zu dem das Element gehört. |
| parentNode | Gibt den übergeordneten Knoten des Elements zurück. |
| Präfix | Legt das Namespace-Präfix des Elements fest oder gibt es zurück. |
| previousSibling | Gibt den Knoten zurück, der dem Element unmittelbar vorausgeht. |
| schemaTypeInfo | Gibt die dem Element zugeordneten Typinformationen zurück. |
| tagName | Gibt den Namen des Elements zurück. |
| textContent | Legt den Textinhalt des Elements und seiner Nachkommen fest oder gibt ihn zurück. |
Methoden des Element-Objekts
| Methoden | Beschreibung |
|---|---|
| appendChild() | Fügt einen neuen Kindknoten am Ende der Kinderliste des Knotens hinzu. |
| cloneNode() | Knoten klonen. |
| compareDocumentPosition() | Vergleicht die Dokumentposition zweier Knoten. |
| getAttribute() | Gibt den Wert des Attributs zurück. |
| getAttributeNS() | Gibt den Wert des Attributs zurück (mit Namespace). |
| getAttributeNode() | Gibt den Attributknoten als Attribute-Objekt zurück. |
| getAttributeNodeNS() | Gibt den Attributknoten als Attribute-Objekt zurück (mit Namespace). |
| getElementsByTagName() | Gibt eine NodeList passender Elementknoten und ihrer Kindknoten zurück. |
| getElementsByTagNameNS() | Gibt eine NodeList passender Elementknoten (mit Namespace) und ihrer Kindknoten zurück. |
| getFeature(feature,version) | Gibt ein DOM-Objekt zurück, das eine spezialisierte API mit den angegebenen Merkmalen und der angegebenen Version ausführen kann. |
| getUserData(key) | Gibt das Objekt zurück, das auf dem Knoten einem Schlüssel zugeordnet ist. Dieses Objekt muss zuvor diesem Knoten durch Aufruf von setUserData mit demselben Schlüssel zugewiesen worden sein. |
| hasAttribute() | Gibt zurück, ob das Element ein Attribut mit dem angegebenen Namen besitzt. |
| hasAttributeNS() | Gibt zurück, ob das Element ein Attribut mit dem angegebenen Namen und Namensraum besitzt. |
| hasAttributes() | Gibt zurück, ob das Element Attribute besitzt. |
| hasChildNodes() | Gibt zurück, ob das Element Kindknoten besitzt. |
| insertBefore() | Fügt einen neuen Kindknoten vor einem vorhandenen Kindknoten ein. |
| isDefaultNamespace(URI) | Gibt zurück, ob der angegebene namespaceURI der Standard ist. |
| isEqualNode() | Prüft, ob zwei Knoten gleich sind. |
| isSameNode() | Prüft, ob zwei Knoten derselbe Knoten sind. |
| isSupported(feature,version) | Gibt zurück, ob das angegebene Feature auf diesem Element unterstützt wird. |
| lookupNamespaceURI() | Gibt die Namespace-URI zurück, die mit dem angegebenen Präfix übereinstimmt. |
| lookupPrefix() | Gibt das Präfix zurück, das dem angegebenen Namespace-URI entspricht. |
| normalize() | Überführt alle Textknoten unter dem Knoten (einschließlich Attribute) in eine "normale" Form, in der nur Struktur (wie Elemente, Kommentare, Verarbeitungsanweisungen, CDATA-Abschnitte und Entitätsreferenzen) Textknoten trennt; zum Beispiel existieren weder benachbarte Textknoten noch leere Textknoten. |
| removeAttribute() | Entfernt das angegebene Attribut. |
| removeAttributeNS() | Entfernt das angegebene Attribut (mit Namespace). |
| removeAttributeNode() | Entfernt den angegebenen Attributknoten. |
| removeChild() | Entfernt den untergeordneten Knoten. |
| replaceChild() | Ersetzt den untergeordneten Knoten. |
| setUserData(key,data,handler) | Ordnet einem Schlüssel auf dem Element ein Objekt zu. |
| setAttribute() | Fügt ein neues Attribut hinzu. |
| setAttributeNS() | Fügt ein neues Attribut hinzu (mit Namensraum). |
| setAttributeNode() | Fügt einen neuen Attributknoten hinzu. |
| setAttributeNodeNS(attrnode) | Fügt einen neuen Attributknoten hinzu (mit Namensraum). |
| setIdAttribute(name,isId) | Wenn die isId-Eigenschaft des Attribute-Objekts true ist, deklariert diese Methode das angegebene Attribut als benutzerbestimmtes ID-Attribut. |
| setIdAttributeNS(uri,name,isId) | Wenn die isId-Eigenschaft des Attribute-Objekts true ist, deklariert diese Methode das angegebene Attribut als benutzerbestimmtes ID-Attribut (mit Namensraum). |
| setIdAttributeNode(idAttr,isId) | Wenn die isId-Eigenschaft des Attribute-Objekts true ist, deklariert diese Methode das angegebene Attribut als benutzerbestimmtes ID-Attribut. |
Weitere Erweiterungen