org.w3c.dom
接口 NamedNodeMap

public interface NamedNodeMap

实现 NamedNodeMap 接口的对象用于表示可以通过名称访问的节点的集合。注意，NamedNodeMap 不从 NodeList 继承；不以任何特定的顺序维护 NamedNodeMaps。在实现 NamedNodeMap 的对象中包含的对象还可以通过顺序索引进行访问，但只允许方便地枚举 NamedNodeMap 的内容，并不意味着 DOM 指定这些节点的顺序。

DOM 中的 NamedNodeMap 对象是活动的。

另请参见 Document Object Model (DOM) Level 3 Core Specification。

getNamedItem

Node getNamedItem(String name)

检索通过名称指定的节点。

参数：

name - 要检索的节点的 nodeName。

返回：

具有指定 nodeName 的 Node（类型不限）；如果它不标识此映射中的任何节点，则返回 null。

setNamedItem

Node setNamedItem(Node arg)
                  throws DOMException

使用 nodeName 属性添加节点。如果具有此名称的节点已经出现在此映射中，则用新的节点替换它。用自身替换节点无效。
由于 nodeName 属性用于派生必须在其下存储节点的名称，因为名称可能冲突无法存储多个某种类型的节点（具有“特殊的”字符串值的那些节点）。这被视为优于允许为节点起别名。

参数：

arg - 在此映射中存储的节点。以后该节点可使用其 nodeName 属性的值来访问。

返回：

如果新 Node 替换现有节点，则返回被替换的 Node；否则返回 null。

抛出：

DOMException - WRONG_DOCUMENT_ERR: 如果 arg 是从不同的文档创建的，不是从创建此映射的文档创建的，则引发此异常。
NO_MODIFICATION_ALLOWED_ERR: 如果此映射为只读的，则引发此异常。
INUSE_ATTRIBUTE_ERR: 如果 arg 为已经是另一 Element 对象的属性的 Attr，则引发此异常。DOM 用户必须显式地克隆 Attr 节点，以便在其他元素中重新使用它们。
HIERARCHY_REQUEST_ERR: 如果试图添加不属于此 NamedNodeMap 的节点，则引发此异常。这样的例子包括试图将某些内容而不是 Attr 节点添加到属性的元素映射，或者将非实体节点添加到实体的 DocumentType 映射。

removeNamedItem

Node removeNamedItem(String name)
                     throws DOMException

移除通过名称指定的节点。当此映射包含连接到元素的属性时，如果知道移除的属性具有默认值，则在可用时立即出现包括默认值以及相应名称空间 URI、本地名称和前缀的属性。

参数：

name - 要移除的节点的 nodeName。

返回：

如果存在具有这样的名称的节点，则返回从此映射移除的节点。

抛出：

DOMException - NOT_FOUND_ERR: 如果此映射中不存在命名为 name 的节点，则引发此异常。
NO_MODIFICATION_ALLOWED_ERR: 如果此映射为只读的，则引发此异常。

item

Node item(int index)

返回映射中第 index 个项。如果 index 大于或等于此映射中的节点数，则这将返回 null。

参数：

index - 此映射中的索引。

返回：

该映射中第 index 个位置处的节点；如果是无效索引，则返回 null。

getLength

int getLength()

此映射中的节点数。有效子节点索引的范围为 0 到 length-1。

getNamedItemNS

Node getNamedItemNS(String namespaceURI,
                    String localName)
                    throws DOMException

检索通过本地名称和名称空间 URI 指定的节点。
按照 [XML Namespaces]，如果应用程序希望没有名称空间，则它们必须将值 null 用作方法的 namespaceURI 参数。

参数：

namespaceURI - 要检索的节点的名称空间 URI。

localName - 要检索的节点的本地名称。

返回：

具有指定本地名称和名称空间 URI 的 Node（类型不限）；如果它们不标识此映射中的任何节点，则返回 null。

抛出：

DOMException - NOT_SUPPORTED_ERR: 如果实现不支持功能 "XML" 且文档中公开的语言不支持 XML 名称空间（如 [HTML 4.01]），则可能引发此异常。

从以下版本开始：

DOM Level 2

setNamedItemNS

Node setNamedItemNS(Node arg)
                    throws DOMException

使用其 namespaceURI 和 localName 添加节点。如果具有该名称空间 URI 和该本地名称的节点已经出现在此映射中，则用新节点替换它。用自身替换节点无效。
按照 [XML Namespaces]，如果应用程序希望没有名称空间，则它们必须将值 null 用作方法的 namespaceURI 参数。

参数：

arg - 存储在此映射中的节点。以后该节点可使用其 namespaceURI 和 localName 属性的值进行访问。

返回：

如果新 Node 替换现有节点，则返回被替换的 Node；否则返回 null。

抛出：

DOMException - WRONG_DOCUMENT_ERR: 如果 arg 是从不同的文档创建的，不是从创建此映射的文档创建的，则引发此异常。
NO_MODIFICATION_ALLOWED_ERR: 如果此映射为只读的，则引发此异常。
INUSE_ATTRIBUTE_ERR: 如果 arg 为已经是另一 Element 对象的属性的 Attr，则引发此异常。DOM 用户必须显式地克隆 Attr 节点，以便在其他元素中重新使用它们。
HIERARCHY_REQUEST_ERR: 如果试图添加不属于此 NamedNodeMap 的节点，则引发此异常。这样的例子包括试图将某些内容而不是 Attr 节点添加到属性的元素映射，或者将非实体节点添加到实体的 DocumentType 映射。
NOT_SUPPORTED_ERR:如果实现不支持功能 "XML" 且文档公开的语言不支持 XML 名称空间（如 [HTML 4.01]），则可能引发此异常。

从以下版本开始：

DOM Level 2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                       throws DOMException

移除通过本地名称和名称空间 URI 指定的节点。此映射中包含连接到一个元素的属性时，可能知道移除的属性具有默认值，由 Node 接口的属性返回。如果是这样，当适当时包含默认值以及相应名称空间 URI、本地名称和前缀的属性立即出现。
按照 [XML Namespaces]，如果应用程序希望没有名称空间，则它们必须将值 null 用作方法的 namespaceURI 参数。

参数：

namespaceURI - 要移除的节点的名称空间 URI。

localName - 要移除的节点的本地名称。

返回：

如果存在具有这样的本地名称和名称空间 URI 的节点，则返回从此映射移除的节点。

抛出：

DOMException - NOT_FOUND_ERR:如果此映射中存在具有指定 namespaceURI 和 localName 的节点，则引发此异常。
NO_MODIFICATION_ALLOWED_ERR: 如果此映射为只读的，则引发此异常。
NOT_SUPPORTED_ERR: 如果实现不支持功能 "XML" 且文档公开的语言不支持 XML 名称空间（如 [HTML 4.01]），则可能引发此异常。

从以下版本开始：

DOM Level 2

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。