compact2, compact3

org.w3c.dom

Interface NamedNodeMap

public interface NamedNodeMap

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

NamedNodeMap DOM中的对象是活的。

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

方法摘要

Modifier and Type	Method and Description
int	getLength() 该地图中的节点数。
Node	getNamedItem(String name) 检索由name指定的节点。
Node	getNamedItemNS(String namespaceURI, String localName) 检索由本地名称和命名空间URI指定的节点。
Node	item(int index) 返回地图中的 index项目。
Node	removeNamedItem(String name) 删除由name指定的节点。
Node	removeNamedItemNS(String namespaceURI, String localName) 删除由本地名称和命名空间URI指定的节点。
Node	setNamedItem(Node arg) 使用其 nodeName属性添加节点。
Node	setNamedItemNS(Node arg) 使用其 namespaceURI和 localName添加节点。

方法详细信息

getNamedItem

Node getNamedItem(String name)

检索由name指定的节点。

参数

name - 要检索的节点的 nodeName 。

结果

A Node （任何类型的），具有指定的 nodeName ，或 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 ，则Element 。 DOM用户必须明确克隆Attr节点，以便在其他元素中重新使用它们。
HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。 示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。

removeNamedItem

Node removeNamedItem(String name)
              throws DOMException

删除由name指定的节点。 当此映射包含附加到元素的属性时，如果已知已删除的属性具有默认值，则属性会立即显示，其中包含默认值以及相应的命名空间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级别2

setNamedItemNS

Node setNamedItemNS(Node arg)
             throws DOMException

使用其namespaceURI和localName添加节点。 如果具有该名称空间URI和该本地名称的节点已经存在于该映射中，则该节点将被新映射替换。 自行替换节点不起作用。
Per [ 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 ，则Element 。 DOM用户必须明确克隆Attr节点，以便在其他元素中重新使用它们。
HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。 示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。
NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能会被引发。

从以下版本开始：

DOM级别2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                throws DOMException

删除由本地名称和命名空间URI指定的节点。 当此映射包含附加到元素的属性（如Node接口的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级别2