All Packages Class Hierarchy This Package Previous Next Index
Element
nodes.
Assume the following XML document:<elementExample id="demo">
<subelement1/>
<subelement2><subsubelement/></subelement2>
</elementExample>
When represented using DOM, the top node is an Element
node
for "elementExample", which contains two child Element
nodes,
one for "subelement1" and one for "subelement2". "subelement1" contains no
child nodes.
Elements may have attributes associated with them; since the
Element
interface inherits from Node
, the generic
Node
interface method getAttributes
may be used
to retrieve the set of all attributes for an element. There are methods on
the Element
interface to retrieve either an Attr
object by name or an attribute value by name. In XML, where an attribute
value may contain entity references, an Attr
object should be
retrieved to examine the possibly fairly complex sub-tree representing the
attribute value. On the other hand, in HTML, where all attributes have
simple string values, methods to directly access an attribute value can
safely be used as a convenience.
Attr
node by name.
NodeList
of all descendant elements with a given
tag name, in the order in which they would be encountered in a preorder
traversal of the Element
tree.
Text
nodes in the full depth of the sub-tree
underneath this Element
into a "normal" form where only
markup (e.g., tags, comments, processing instructions, CDATA sections,
and entity references) separates Text
nodes, i.e., there
are no adjacent Text
nodes.
public abstract String getTagName()
tagName
has
the value "elementExample"
. Note that this is
case-preserving in XML, as are all of the operations of the DOM. The
HTML DOM returns the tagName
of an HTML element in the
canonical uppercase form, regardless of the case in the source HTML
document.
public abstract String getAttribute(String name)
Attr
value as a string, or the empty string if
that attribute does not have a specified or default value.
public abstract void setAttribute(String name, String value) throws DOMException
Attr
node plus any Text
and
EntityReference
nodes, build the appropriate subtree, and
use setAttributeNode
to assign it as the value of an
attribute.
public abstract void removeAttribute(String name) throws DOMException
public abstract Attr getAttributeNode(String name)
Attr
node by name.
Attr
node with the specified attribute name or
null
if there is no such attribute.
public abstract Attr setAttributeNode(Attr newAttr) throws DOMException
Attr
node to add to the attribute list.
newAttr
attribute replaces an existing
attribute with the same name, the previously existing
Attr
node is returned, otherwise null
is
returned.
newAttr
was created from a
different document than the one that created the element.
newAttr
is already an
attribute of another Element
object. The DOM user must
explicitly clone Attr
nodes to re-use them in other
elements.
public abstract Attr removeAttributeNode(Attr oldAttr) throws DOMException
Attr
node to remove from the attribute
list. If the removed Attr
has a default value it is
immediately replaced.
Attr
node that was removed.
oldAttr
is not an attribute
of the element.
public abstract NodeList getElementsByTagName(String name)
NodeList
of all descendant elements with a given
tag name, in the order in which they would be encountered in a preorder
traversal of the Element
tree.
Element
nodes.
public abstract void normalize()
Text
nodes in the full depth of the sub-tree
underneath this Element
into a "normal" form where only
markup (e.g., tags, comments, processing instructions, CDATA sections,
and entity references) separates Text
nodes, i.e., there
are no adjacent Text
nodes. This can be used to ensure
that the DOM view of a document is the same as if it were saved and
re-loaded, and is useful when operations (such as XPointer lookups) that
depend on a particular document tree structure are to be used.
All Packages Class Hierarchy This Package Previous Next Index