compact2, compact3

org.w3c.dom

Interface NamedNodeMap

public interface NamedNodeMap

对象实现的 NamedNodeMap接口来表示，可以通过名称访问节点的集合。注意， NamedNodeMap不是继承自 NodeList； NamedNodeMaps不是建立在任何特定的顺序。包含在实施 NamedNodeMap对象的对象也可以是一个序数索引访问，但这仅仅是为了让一个 NamedNodeMap内容方便枚举，而并不意味着DOM指定命令，这些节点。

在DOM对象是生活NamedNodeMap。

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

方法摘要

Modifier and Type	Method and Description
int	getLength() 在这个Map中的节点的数量。
Node	getNamedItem(String name) 检索由名称指定的节点。
Node	getNamedItemNS(String namespaceURI, String localName) 检索指定一个节点的本地名称和命名空间URI。
Node	item(int index) 返回 indexth项目Map。
Node	removeNamedItem(String 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 -节点检索 nodeName。

结果

一个 Node（任何类型）与指定的 nodeName，或 null如果不确定在Map上的任何节点。

setNamedItem

Node setNamedItem(Node arg)
           throws DOMException

添加一个节点使用其 nodeName属性。如果这个映射中已经存在该名称的节点，则将被新的一个替换为新的。替换一个节点本身没有影响。
as的 nodeName属性是用来获得名称的节点必须保存下，某些类型的多个节点（那些有“特殊”的字符串值）不能被存储为名称冲突。这是最好的节点可以是多余的。

参数

arg -节点中存储的Map。节点会使用它的 nodeName属性的值。

结果

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

异常

DOMException - wrong_document_err：如果 arg是一比一，创造了这个Map不同的文档创建了。
no_modification_allowed_err：如果这张Map是只读了。
inuse_attribute_err：如果 arg是 Attr，已经是另一个对象的一个属性，提出 Element。DOM节点的用户必须显式地克隆 Attr重复使用在其他元素。
hierarchy_request_err：如果尝试添加一个节点不属于这的NamedNodeMap[指定节点映射]了。例子包括试图插入一些比其他属性的节点的属性元素的Map，或非实体的节点到文档类型的Map实体。

removeNamedItem

Node removeNamedItem(String name)
              throws DOMException

移除指定名称的节点。当这个Map包含附加到一个元素的属性，如果被删除的属性是已知有一个默认值，一个属性直接包含默认值以及对应的命名空间URI、本地名称和前缀适用时。

参数

name节点的删除 nodeName。

结果

如果一个节点具有这样的名称，该节点将从该Map中删除。

异常

DOMException - not_found_err：如果没有节点命名 name这个Map了。
no_modification_allowed_err：如果这张Map是只读了。

item

Node item(int index)

返回 indexth项目Map。如果 index大于或等于该图的节点数，返回 null。

参数

index指数到这个Map。

结果

在Map的 indexth位置的节点，或 null如果这不是一个有效的指标。

getLength

int getLength()

在这个Map中的节点的数量。有效的子节点的指数范围是 0到 length-1包容。

getNamedItemNS

Node getNamedItemNS(String namespaceURI,
                    String localName)
             throws DOMException

检索指定一个节点的本地名称和命名空间URI。
per [ XML Namespaces ]，应用程序必须使用null值作为方法的参数namespaceuri如果他们希望没有命名空间。

参数

namespaceURI -节点检索命名空间URI。

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

结果

一个 Node（任何类型）具有指定的本地名称和命名空间URI或 null如果他们不确定在Map上的任何节点。

异常

DOMException - not_supported_err：可提高如果实现不支持此功能的“XML”通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。

从以下版本开始：

DOM级别2

setNamedItemNS

Node setNamedItemNS(Node arg)
             throws DOMException

添加一个节点使用其 namespaceURI和 localName。如果一个节点和命名空间URI和本地名称已经在这张Map上，它被替换为新的。替换一个节点本身没有影响。
per [ XML Namespaces ]，应用程序必须使用null值作为方法的参数namespaceuri如果他们希望没有命名空间。

参数

arg -节点中存储的Map。节点会使用它的 namespaceURI和 localName属性值。

结果

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

异常

DOMException - wrong_document_err：如果 arg是一比一，创造了这个Map不同的文档创建了。
no_modification_allowed_err：如果这张Map是只读了。
inuse_attribute_err：如果 arg是 Attr，已经是另一个对象的一个属性，提出 Element。DOM节点的用户必须显式地克隆 Attr重复使用在其他元素。
hierarchy_request_err：如果尝试添加一个节点不属于这的NamedNodeMap[指定节点映射]了。例子包括试图插入一些比其他属性的节点的属性元素的Map，或非实体的节点到文档类型的Map实体。
not_supported_err：可提高如果实现不支持此功能的“XML”通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。

从以下版本开始：

DOM级别2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                throws DOMException

删除一个节点指定的本地名称和命名空间URI。一个被删除的属性可能有一个默认值时，该Map包含附加到一个元素的属性，通过属性的属性返回的 Node接口。如果是这样的话，一个属性直接包含默认值以及对应的命名空间URI、本地名称和前缀适用时。
per [ XML Namespaces ]，应用程序必须使用null值作为方法的参数namespaceuri如果他们希望没有命名空间。

参数

namespaceURI -节点删除命名空间URI。

localName -节点的本地名称删除。

结果

从这张Map的节点删除节点如果这样的本地名称和命名空间URI的存在。

异常

DOMException - not_found_err：如果有指定的 namespaceURI和 localName这个Map没有结了。
no_modification_allowed_err：如果这张Map是只读了。
not_supported_err：可提高如果实现不支持此功能的“XML”通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。

从以下版本开始：

DOM级别2