XML DOM - Element 对象
Element 对象
Element 对象代表 XML 文档中的一个元素。元素可以包含属性、其他元素或文本。如果元素包含文本,则文本将以文本节点的形式表示。
重要! 文本始终存储在文本节点中。DOM 处理中的一个常见错误是导航到元素节点并期望它包含文本。然而,即使是最简单的元素节点,其下方也有一个文本节点。例如,在 <year>2005</year> 中,有一个元素节点 (year),在其下方有一个文本节点,其中包含文本 (2005)。
由于 Element 对象也是一个 Node,因此它继承了 Node 对象的属性和方法。
Element 对象属性
| 属性 | 描述 |
|---|---|
| attributes | 返回元素的属性的 NamedNodeMap |
| baseURI | 返回元素的绝对基 URI |
| childNodes | 返回元素的子节点的 NodeList |
| firstChild | 返回元素的第一个子节点 |
| lastChild | 返回元素的最后一个子节点 |
| localName | 返回元素的名称的局部部分 |
| namespaceURI | 返回元素的命名空间 URI |
| nextSibling | 返回紧跟在元素之后的节点 |
| nodeName | 返回节点的名称,具体取决于其类型 |
| nodeType | 返回节点的类型 |
| ownerDocument | 返回元素的根元素(文档对象) |
| parentNode | 返回元素的父节点 |
| prefix | 设置或返回元素的命名空间前缀 |
| previousSibling | 返回紧靠元素之前的节点 |
| schemaTypeInfo | 返回与元素关联的类型信息 |
| tagName | 返回元素名称 |
| textContent | 设置或返回元素及其后代的文本内容 |
Element 对象方法
| 方法 | 描述 |
|---|---|
| appendChild() | 将新的子节点添加到节点子节点列表的末尾 |
| cloneNode() | 克隆节点 |
| compareDocumentPosition() | 比较两个节点的文档位置 |
| getAttribute() | 返回值属性 |
| getAttributeNS() | 返回值属性(带命名空间) |
| getAttributeNode() | 返回一个 Attribute 对象形式的属性节点 |
| getAttributeNodeNS() | 返回一个 Attribute 对象形式的属性节点(带命名空间) |
| getElementsByTagName() | 返回匹配的元素节点及其子节点的 NodeList |
| getElementsByTagNameNS() | 返回匹配的元素节点(带命名空间)及其子节点的 NodeList |
| getFeature(feature,version) | 返回实现指定功能和版本专门 API 的 DOM 对象 |
| getUserData(key) | 返回与此节点上的键关联的对象。该对象必须首先通过使用相同的键调用 setUserData 来设置到此节点 |
| hasAttribute() | 返回一个元素是否具有与指定名称匹配的任何属性 |
| hasAttributeNS() | 返回一个元素是否具有与指定名称和命名空间匹配的任何属性 |
| hasAttributes() | 返回一个元素是否具有任何属性 |
| hasChildNodes() | 返回一个元素是否具有任何子节点 |
| insertBefore() | 在现有子节点之前插入新的子节点 |
| isDefaultNamespace(URI) | 返回指定的 namespaceURI 是否为默认 |
| isEqualNode() | 检查两个节点是否相等 |
| lookupNamespaceURI() | 返回匹配指定前缀的命名空间 URI |
| lookupPrefix() | 返回匹配指定命名空间 URI 的前缀 |
| normalize() | 将此元素下的所有文本节点(包括属性)放入“正常”形式,其中只有结构(例如,元素、注释、处理指令、CDATA 部分和实体引用)分隔文本节点,即不存在相邻的文本节点或空文本节点 |
| removeAttribute() | 移除指定的属性 |
| removeAttributeNS() | 移除指定的属性(带命名空间) |
| removeAttributeNode() | 移除指定的属性节点 |
| removeChild() | 移除子节点 |
| replaceChild() | 替换子节点 |
| setUserData(key,data,handler) | 将对象与元素上的键关联 |
| setAttribute() | 添加新属性 |
| setAttributeNS() | 添加新属性(带命名空间) |
| setAttributeNode() | 添加新属性节点 |
| setAttributeNodeNS(attrnode) | 添加新属性节点(带命名空间) |
| setIdAttribute(name,isId) | 如果 Attribute 对象的 isId 属性为 true,则此方法声明指定的属性为用户定义的 ID 属性 |
| setIdAttributeNS(uri,name,isId) | 如果 Attribute 对象的 isId 属性为 true,则此方法声明指定的属性(带命名空间)为用户定义的 ID 属性 |
| setIdAttributeNode(idAttr,isId) | 如果 Attribute 对象的 isId 属性为 true,则此方法声明指定的属性为用户定义的 ID 属性 |