XML DOM - Element 对象
Element 对象表示 XML 文档中的元素。
Element 对象
Element 对象表示 XML 文档中的元素。元素可包含属性、其他元素或文本。如果元素含有文本,则在文本节点中表示该文本。
重要事项:文本永远存储在文本节点中。在 DOM 处理过程中的一个常见的错误是,导航到元素节点,并认为此节点含有文本。不过,即使最简单的元素节点之下也拥有文本节点。举例,在 <year>2005</year> 中,有一个元素节点(year),同时此节点之下存在一个文本节点,其中含有文本(2005)。
由于元素对象也是一种节点,因此它可继承 Node 对象的属性和方法。
Element 对象的属性
| 属性 | 描述 | IE | F | O | W3C |
|---|---|---|---|---|---|
| attributes | 返回元素的属性的 NamedNodeMap | 5 | 1 | 9 | Yes |
| baseURI | 返回元素的绝对基准 URI | No | 1 | No | Yes |
| childNodes | 返回元素的子节点的 NodeList | 5 | 1 | 9 | Yes |
| firstChild | 返回元素的首个子节点 | 5 | 1 | 9 | Yes |
| lastChild | 返回元素的最后一个子节点 | 5 | 1 | 9 | Yes |
| localName | 返回元素名称的本地部分 | No | 1 | 9 | Yes |
| namespaceURI | 返回元素的命名空间 URI | No | 1 | 9 | Yes |
| nextSibling | 返回元素之后紧跟的节点 | 5 | 1 | 9 | Yes |
| nodeName | 返回节点的名称,依据其类型。 | 5 | 1 | 9 | Yes |
| nodeType | 返回节点的类型 | 5 | 1 | 9 | Yes |
| ownerDocument | 返回元素所属的根元素 (document 对象) | 5 | 1 | 9 | Yes |
| parentNode | 返回元素的父节点 | 5 | 1 | 9 | Yes |
| prefix | 设置或返回元素的命名空间前缀 | No | 1 | 9 | Yes |
| previousSibling | 返回元素之前紧随的节点 | 5 | 1 | 9 | Yes |
| schemaTypeInfo | 返回与元素相关联的类型信息 | No | Yes | ||
| tagName | 返回元素的名称 | 5 | 1 | 9 | Yes |
| textContent | 设置或返回元素及其后代的文本内容 | No | 1 | No | Yes |
| text | 返回节点及其后代的文本 (IE-only) | 5 | No | No | No |
| xml | 返回节点及其后代的 XML (IE-only) | 5 | No | No | No |
Element 对象的方法
| 方法 | 描述 | IE | F | O | W3C |
|---|---|---|---|---|---|
| appendChild() | 向节点的子节点列表末尾添加新的子节点。 | 5 | 1 | 9 | Yes |
| cloneNode() | 克隆节点。 | 5 | 1 | 9 | Yes |
| compareDocumentPosition() | 比较两节点的文档位置。 | No | 1 | No | Yes |
| dispatchEvent() | 给节点分派一个合成事件。 | No | 1 | 9 | Yes |
| getAttribute() | 返回属性的值。 | 5 | 1 | 9 | Yes |
| getAttributeNS() | 返回属性的值。 | No | 1 | 9 | Yes |
| getAttributeNode() | 以 Attribute 对象返回属性节点。 | 5 | 1 | 9 | Yes |
| getAttributeNodeNS() | 以 Attribute 对象返回属性节点。 | No | 9 | Yes | |
| getElementsByTagName() | 找到具有指定标签名的子孙元素。 | 5 | 1 | 9 | Yes |
| getElementsByTagNameNS() | 找到具有指定标签名和命名空间的元素。 | No | 1 | 9 | Yes |
| getFeature(feature,version) | 返回 DOM 对象,此对象可执行拥有指定特性和版本的专门的 API。 | No | Yes | ||
| getUserData(key) | 返回关联节点上键的对象。此对象必须首先通过使用相同的键来调用 setUserData 来设置到此节点。 | No | Yes | ||
| hasAttribute() | 返回元素是否拥有指定的属性。 | 5 | 1 | 9 | Yes |
| hasAttributeNS() | 返回元素是否拥有指定的属性。 | No | 1 | 9 | Yes |
| hasAttributes() | 返回元素是否拥有属性。 | 5 | 1 | 9 | Yes |
| hasChildNodes() | 返回元素是否拥有子节点。 | 5 | 1 | 9 | Yes |
| insertBefore() | 在已有的子节点之前插入一个新的子节点。 | 5 | 1 | 9 | Yes |
| isDefaultNamespace(URI) | 返回指定的命名空间 URI 是否为默认。 | No | Yes | ||
| isEqualNode() | 检查两节点是否相等。 | No | No | No | Yes |
| isSameNode() | 检查两节点是否为同一节点。 | No | 1 | No | Yes |
| isSupported(feature,version) | 返回指定的特性是否在此元素上得到支持。 | 9 | Yes | ||
| lookupNamespaceURI() | 返回匹配指定前缀的命名空间 URI。 | No | 1 | No | Yes |
| lookupPrefix() | 返回匹配指定的命名空间 URI 的前缀。 | No | 1 | No | Yes |
| normalize() | 5 | 1 | 9 | Yes | |
| removeAttribute() | 删除指定的属性。 | 5 | 1 | 9 | Yes |
| removeAttributeNS() | 删除指定的属性。 | No | 1 | 9 | Yes |
| removeAttributeNode() | 删除指定的属性节点。 | 5 | 1 | 9 | Yes |
| removeChild() | 删除子节点。 | 5 | 1 | 9 | Yes |
| replaceChild() | 替换子节点。 | 5 | 1 | 9 | Yes |
| setUserData(key,data,handler) | 把对象关联到元素上的键。 | No | Yes | ||
| setAttribute() | 添加新属性。 | 5 | 1 | 9 | Yes |
| setAttributeNS() | 添加新属性。 | 1 | 9 | Yes | |
| setAttributeNode() | 添加新的属性节点。 | 5 | 1 | 9 | Yes |
| setAttributeNodeNS(attrnode) | 添加新的属性节点。 | 9 | Yes | ||
| setIdAttribute(name,isId) | 如果 Attribute 对象 isId 属性为 true,那么此方法会把指定的属性声明为一个用户确定 ID 的属性(user-determined ID attribute)。 | No | Yes | ||
| setIdAttributeNS(uri,name,isId) | 如果 Attribute 对象 isId 属性为 true,那么此方法会把指定的属性声明为一个用户确定 ID 的属性(user-determined ID attribute)(带有命名空间)。 | No | Yes | ||
| setIdAttributeNode(idAttr,isId) | 如果 Attribute 对象 isId 属性为 true,那么此方法会把指定的属性声明为一个用户确定 ID 的属性(user-determined ID attribute)。 | No | Yes |