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