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.

@safe

interface NamedNodeMap {

Node item(size_t index);

size_t length [@property getter];

int opApply(int delegate(Node) @(safe) foreachBody);

Node getNamedItem(DOMString name);

Node setNamedItem(Node arg);

Node removeNamedItem(DOMString name);

Node getNamedItemNS(DOMString namespaceURI, DOMString localName);

Node setNamedItemNS(Node arg);

Node removeNamedItemNS(DOMString namespaceURI, DOMString localName);

}

Members

Functions

getNamedItem Node getNamedItem(DOMString name): Retrieves a node specified by name.
getNamedItemNS Node getNamedItemNS(DOMString namespaceURI, DOMString localName): 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 Node item(size_t index): 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.
opApply int opApply(int delegate(Node) @(safe) foreachBody): Undocumented in source. Be warned that the author may not have intended to support it.
removeNamedItem Node removeNamedItem(DOMString name): 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 Node removeNamedItemNS(DOMString namespaceURI, DOMString localName): 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 Node setNamedItem(Node arg): 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 Node setNamedItemNS(Node arg): 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.

Properties

length size_t length [@property getter]: The number of nodes in the list. The range of valid child node indices is 0 to length-1 inclusive.

NamedNodeMap

Members

Functions

Properties

Meta

Source