-
public interface NamedNodeMap
实现NamedNodeMap
接口的对象用于表示可以通过名称访问的节点集合。 请注意,NamedNodeMap
不继承自NodeList
;NamedNodeMaps
没有以任何特定的顺序进行维护。 包含在实现NamedNodeMap
的对象中的对象也可以由序数索引访问,但这只是为了方便地枚举NamedNodeMap
的内容,并不意味着DOM指定这些节点的顺序。NamedNodeMap
DOM中的对象是活的。
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 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
节点,则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
- 参数
-
namespaceURI
- 要检索的节点的命名空间URI。 -
localName
- 要检索的节点的本地名称。 - 结果
-
具有指定的本地名称和命名空间URI的
Node
(任何类型的),如果它们不标识此映射中的任何节点,null
。 - 异常
-
DOMException
- NOT_SUPPORTED_ERR:如果实现不支持功能“XML”,并且通过文档公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能会被引发。 - 从以下版本开始:
- 1.4,DOM Level 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
,则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 ]),则可能会被引发。 - 从以下版本开始:
- 1.4,DOM Level 2
-
removeNamedItemNS
Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException
删除由本地名称和命名空间URI指定的节点。 当该映射包含连接到元素的属性(由Node
接口的attributes属性返回)时,已知删除的属性可能具有默认值。 如果是这样,属性会立即出现,包含默认值以及相应的命名空间URI,本地名称和前缀(如果适用)。
Per [ XML Namespaces ],应用程序必须使用值null作为方法的namespaceURI参数,如果他们希望没有命名空间。- 参数
-
namespaceURI
- 要删除的节点的命名空间URI。 -
localName
- 要删除的节点的本地名称。 - 结果
- 如果具有这样的本地名称和命名空间URI的节点存在,则从该映射中删除该节点。
- 异常
-
DOMException
- NOT_FOUND_ERR:如果此地图中没有指定namespaceURI
和localName
节点,namespaceURI
其localName
。
NO_MODIFICATION_ALLOWED_ERR:如果此地图是只读的,则提高。
NOT_SUPPORTED_ERR:如果实现不支持功能“XML”,并且通过文档公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能会被引发。 - 从以下版本开始:
- 1.4,DOM Level 2
-
-