|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Objects implementing the NamedNodeMap interface are
used to represent collections of nodes that can be accessed by name. Note
that NamedNodeMap does not inherit from
NodeList; NamedNodeMaps are not maintained in
any particular order. Objects contained in an object implementing
NamedNodeMap may also be accessed by an ordinal index, but
this is simply to allow convenient enumeration of the contents of a
NamedNodeMap, and does not imply that the DOM specifies an
order to these Nodes.
| Property Summary | ||
length |
getLength | The number of nodes in the map. The range of valid child node
indices is 0 to |
| Method Summary | |
int |
getLength()
Returns the value of the length property. |
Node |
getNamedItem(java.lang.String name)
Retrieves a node specified by name. |
Node |
item(int index)
Returns the indexth item in the map. |
Node |
removeNamedItem(java.lang.String name)
Removes a node specified by name. |
Node |
setNamedItem(Node arg)
Adds a node using its nodeName attribute. |
| Method Detail |
public Node getNamedItem(java.lang.String name)
Retrieves a node specified by name.
name - Name of a node to retrieve.Node (of any type) with the specified
name, or null if the specified name did not
identify any node in the map.
public Node setNamedItem(Node arg)
throws DOMException
Adds a node using its nodeName attribute.
As the nodeName attribute is used to
derive the name which the node must be stored under, multiple
nodes of certain types (those that have a "special" string
value) cannot be stored as the names would clash. This is seen
as preferable to allowing nodes to be aliased.
arg - A node to store in a named node map. The node will
later be accessible using the value of the
nodeName attribute of the node. If a node with that
name is already present in the map, it is replaced
by the new one.Node replaces an existing node with the
same name the previously existing Node is returned,
otherwise null is returned.arg was created from a different
document than the one that created the NamedNodeMap.NO_MODIFICATION_ALLOWED_ERR: Raised if this
NamedNodeMap is readonly.
INUSE_ATTRIBUTE_ERR: Raised if arg is an Attr
that is already an attribute of another Element object. The
DOM user must explicitly clone Attr
nodes to re-use them in other elements.
public Node removeNamedItem(java.lang.String name)
throws DOMException
Removes a node specified by name. If the removed
node is an Attr with a default value it is immediately
replaced.
name - The name of a node to remove.null
if no node with such a name exists.name in the map.public Node item(int index)
Returns the indexth item in the map.
If index is greater than or equal to the number
of nodes in the map, this returns null.
index - Index into the map.indexth position in the
NamedNodeMap, or null if that is not a
valid index.public int getLength()
length property.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||