所有类
|
|||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
org.w3c.dom
接口 NamedNodeMap
-
public interface NamedNodeMap
实现 NamedNodeMap 接口的对象用于表示可以通过名称访问的节点的集合。注意，NamedNodeMap 不从 NodeList 继承；不以任何特定的顺序维护 NamedNodeMaps。在实现 NamedNodeMap 的对象中包含的对象还可以通过顺序索引进行访问，但只允许方便地枚举 NamedNodeMap 的内容，并不意味着 DOM 指定这些节点的顺序。
DOM 中的 NamedNodeMap 对象是活动的。
另请参见 Document Object Model (DOM) Level 3 Core Specification。
| 方法摘要 | |
|---|---|
int |
getLength() 此映射中的节点数。 |
Node |
getNamedItem(String name) 检索通过名称指定的节点。 |
Node |
getNamedItemNS(String namespaceURI, String localName) 检索通过本地名称和名称空间 URI 指定的节点。 |
Node |
item(int index) 返回映射中第 index 个项。 |
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。- 返回：
-
具有指定
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
