Deklaration

Beschreibung

Methoden
public String	getAttribute(String name)
public String	getAttributeNS(String namespaceURI, String localName)
public Attr	getAttributeNode(String name)
public Attr	getAttributeNodeNS(String namespaceURI, String localName)
public NodeList	getElementsByTagName(String name)
public NodeList	getElementsByTagNameNS(String namespaceURI, String localName)
public String	getTagName()
public boolean	hasAttribute(String name)
public boolean	hasAttribute(String namespaceURI, String localName)
public void	removeAttribute(String name)
public Attr	removeAttributeNode(Attr oldAttr)
public void	removeAttributeNS(String namespaceURI, String localName)
public void	setAttribute(String name, String value)
public Attr	setAttributeNode(Attr newAttr)
public Attr	setAttributeNodeNS(Attr newAttr)
public void	setAttributeNS(String namespaceURI, String qualifiedName, String value)

Methoden im Detail

public String getAttribute(String name)

Liefert den Wert des durch name bezeichneten Attributs zurück. Falls das Element kein Attribut mit diesem Namen hat, wird ein leerer String zurückgegeben, ebenso, wenn es sich um ein #IMPLIED-Attribut handelt, für das im Dokument kein Wert angegeben wurde.

public String getAttributeNS(String namespaceURI, String localName)     

Liefert den Wert des durch den lokalen Namen localName und den Namensraum-URI namespaceURI bezeichneten Attributs zurück. Falls das Element kein Attribut mit diesem Namen hat, wird ein leerer String zurückgegeben, ebenso, wenn es sich um ein #IMPLIED-Attribut handelt, für das im Dokument kein Wert angegeben wurde.

public Attr getAttributeNode(String name)

Liefert den Knoten des durch name bezeichneten Attributs zurück oder null, falls das Element kein Attribut mit diesem Namen hat.

public Attr getAttributeNodeNS(String namespaceURI, String localName)     

Liefert den Knoten des durch den lokalen Namen localName und den Namensraum-URI namespaceURI bezeichneten Attributs zurück oder null, falls das Element kein Attribut mit diesem Namen hat.

public NodeList getElementsByTagName(String name)

Liefert eine NodeList zurück, die alle Elementknoten enthält, die rekursiv unter diesen Knoten liegen und den Tag-Namen name haben. Gibt es keine solchen Knoten, ist die gelieferte Liste leer.

public NodeList getElementsByTagNameNS(String namespaceURI, String localName)     

Liefert eine NodeList zurück, die alle Elementknoten enthält, die rekursiv unter diesen Knoten liegen und zum Element localName in dem durch namespaceURI definierten Namensraum gehören. Die Knoten werden entsprechend ihrer Reihenfolge im Dokument in der Liste eingetragen. Gibt es keine Element-Knoten mit diesem Tag-Namen, ist die zurückgegebene Liste leer. Für beide Parameter kann der Wert "*" angegeben werden, der auf alle Namensräume bzw. alle lokalen Namen paßt.

public String getTagName()

Liefert den Namen des Elements zurück, das dieser Elementknoten repräsentiert.

public boolean hasAttribute(String name)     

Liefert true, wenn das Element ein Attribut mit dem Namen name hat (implizit oder explizit), sonst false.

public boolean hasAttribute(String namespaceURI, String localName)     

Liefert true, wenn das Element ein Attribut mit dem lokalen Namen name im Namensraum namespaceURI hat (implizit oder explizit), sonst false.

public void removeAttribute(String name)

Löscht den Wert des durch name bezeichneten Attributs und setzt das Attribut automatisch auf den Standardwert, sofern es einen gibt. Falls das Element kein Attribut mit diesem Namen hat, bleibt die Methode wirkungslos.

Exception: DOMException

• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.

public Attr removeAttributeNode(Attr oldAttr)

Entfernt den Attributknoten oldAttr von diesem Elementknoten. Falls das von oldAttr dargestellte Attribut einen Standardwert hat, wird automatisch wieder ein entsprechendes Attr-Objekt eingefügt.

Exception: DOMException

• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code NOT_FOUND_ERR, wenn oldAttr nicht in diesem Element-Knoten gefunden wurde.

public void removeAttributeNS(String namespaceURI, String localName)     

Entfernt den durch den lokalen Namen localName und den Namensraum-URI namespaceURI bezeichneten Attributknoten von diesem Elementknoten. Falls das Attribut einen Standardwert hat, wird automatisch wieder ein entsprechendes Attr-Objekt eingefügt.

Exception: DOMException

• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.

public void setAttribute(String name, String value)

Setzt den Wert des durch name bezeichneten Attributs auf value. Falls das Element kein Attribut mit diesem Namen hat, wird es hinzugefügt.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls name ein ungültiges Zeichen enthält.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.

public Attr setAttributeNode(Attr newAttr)

Fügt dem Elementknoten den Attributknoten newAttr hinzu. Falls es bereits einen Attributknoten mit demselben Attributnamen gibt, wird dieser ersetzt. Rückgabewert ist der übergebene Knoten.

Exception: DOMException

• Code INUSE_ATTRIBUTE_ERR, wenn das Objekt newAttr bereits zu einem anderen Element-Knoten gehört..
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code WRONG_DOCUMENT_ERR, wenn das Objekt newAttr von einem anderen Document-Exemplar erzeugt wurde als dem, zu dem dieser Knoten gehört.

public Attr setAttributeNodeNS(Attr newAttr)     

Fügt dem Element den Attribut-Knoten newAttr hinzu. Falls es bereits ein Attribut mit dem gleichen lokalen Namen im gleichen Namensraum gibt, wird dieses Attribut ersetzt und zurückgeliefert. Ansonsten ist der Rückgabewert null.

Exception: DOMException

• Code INUSE_ATTRIBUTE_ERR, wenn das Objekt newAttr bereits zu einem anderen Element-Knoten gehört..
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code WRONG_DOCUMENT_ERR, wenn das Objekt newAttr von einem anderen Document-Exemplar erzeugt wurde als dem, zu dem dieser Knoten gehört.

public void setAttributeNS(String namespaceURI, String qualifiedName, String value)     

Fügt dem Knoten ein Attribut mit dem qualifzierten Elementnamen qualifiedName und dem Namensraum namespaceURI bezeichneten hinzu. Als Wert wird value gesetzt.

qualifiedName besteht aus dem lokalen Elementnamen, dem optional durch einen Doppelpunkt getrennt ein Präfix vorangestellt werden kann. Falls für namespaceURI ein leerer String oder null übergeben wird und qualifiedName gleichzeitig den Präfix xml hat, wird das Attribut dem voreingestellten Namensraum zugeordnet.

Falls es im angegebenen Namensraum bereits ein Attribut mit dem in qualifiedName enthaltenen lokalen Namen gibt, wird sein Wert neu gesetzt. Hierbei wird das Präfix neu gesetzt, sofern es nicht mit dem momentanen Präfix übereinstimmt.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls qualifiedName ein ungültiges Zeichen enthält.
• Code NAME_SPACE_ERR, falls qualifiedName ein ungültiges Format hat, oder falls er das Präfix xml hat und gleichzeitig für namespaceURI ein anderer Wert als null, "" oder "http://www.w3.org/XML/1998/namespace".
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.