Interface NamedNodeMap
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.
NamedNodeMap objects in the DOM are live.
Template arguments
interface NamedNodeMap(DOMString);
Properties
| Name | Type | Description |
|---|---|---|
length
[get]
|
size_t |
The number of nodes in the list. The range of valid child node indices is
0 to length-1 inclusive.
|
Methods
| Name | Description |
|---|---|
getNamedItem
|
Retrieves a node specified by name. |
getNamedItemNS
|
Retrieves a node specified by local name and namespace URI.
Per the XML Namespaces specification, applications must use the value null
as the namespaceURI parameter for methods if they wish to have no namespace.
|
item
|
Returns the indexth item in the collection. If index is greater than
or equal to the number of nodes in the list, this returns null.
|
removeNamedItem
|
Removes a node specified by name. When this map contains the attributes attached to an element, if the removed attribute is known to have a default value, an attribute immediately appears containing the default value as well as the corresponding namespace URI, local name, and prefix when applicable. |
removeNamedItemNS
|
Removes a node specified by local name and namespace URI. A removed attribute
may be known to have a default value when this map contains the attributes attached
to an element, as returned by the attributes attribute of the Node interface.
If so, an attribute immediately appears containing the default value as well
as the corresponding namespace URI, local name, and prefix when applicable.
Per the XML Namespaces specification, applications must use the value null
as the namespaceURI parameter for methods if they wish to have no namespace.
|
setNamedItem
|
Adds a node using its nodeName attribute. If a node with that name is
already present in this map, it is replaced by the new one. Replacing a
node by itself has no effect.
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.
|
setNamedItemNS
|
Adds a node using its namespaceURI and localName. If a node with that
namespace URI and that local name is already present in this map, it is
replaced by the new one. Replacing a node by itself has no effect.
Per the XML Namespaces specification, applications must use the value null
as the namespaceURI parameter for methods if they wish to have no namespace.
|
Authors
Lodovico Giaretta
Copyright
Copyright Lodovico Giaretta 2016 --