XML DOM - 元素 对象
元素对象
元素对象表示 XML 文档中的一个元素。元素可以包含属性、其他元素或文本。如果一个元素包含文本,文本将存储在文本节点中。
重要! 文本始终存储在文本节点中。DOM 处理中常见的错误是导航到元素节点并期望它包含文本。但是,即使是最简单的元素节点在其下方也包含一个文本节点。例如,在 <year>2005</year> 中,有一个元素节点(year),以及一个在其下方的文本节点,该文本节点包含文本(2005)。
因为元素对象也是一个节点,所以它继承了节点对象的属性和方法。
元素对象属性
属性 | 描述 |
---|---|
attributes | 返回元素的属性的 NamedNodeMap |
baseURI | 返回元素的绝对基本 URI |
childNodes | 返回元素的子节点的 NodeList |
firstChild | 返回元素的第一个子节点 |
lastChild | 返回元素的最后一个子节点 |
localName | 返回元素名称的本地部分 |
namespaceURI | 返回元素的命名空间 URI |
nextSibling | 返回紧随元素之后的节点 |
nodeName | 返回节点的名称,取决于其类型 |
nodeType | 返回节点的类型 |
ownerDocument | 返回元素的根元素(文档对象) |
parentNode | 返回元素的父节点 |
prefix | 设置或返回元素的命名空间前缀 |
previousSibling | 返回紧接元素之前的节点 |
schemaTypeInfo | 返回与元素关联的类型信息 |
tagName | 返回元素的名称 |
textContent | 设置或返回元素及其后代的文本内容 |
元素对象方法
方法 | 描述 |
---|---|
appendChild() | 在节点的子节点列表末尾添加一个新的子节点 |
cloneNode() | 克隆一个节点 |
compareDocumentPosition() | 比较两个节点的文档位置 |
getAttribute() | 返回属性的值 |
getAttributeNS() | 返回属性的值(带命名空间) |
getAttributeNode() | 返回属性节点作为 Attribute 对象 |
getAttributeNodeNS() | 返回属性节点(带命名空间)作为 Attribute 对象 |
getElementsByTagName() | 返回匹配元素节点及其子节点的 NodeList |
getElementsByTagNameNS() | 返回匹配元素节点(带命名空间)及其子节点的 NodeList |
getFeature(feature,version) | 返回一个 DOM 对象,该对象实现指定功能和版本的专用 API |
getUserData(key) | 返回与此节点关联的键的对象。该对象必须首先通过调用 setUserData 使用相同的键设置为此节点 |
hasAttribute() | 返回元素是否具有任何匹配指定名称的属性 |
hasAttributeNS() | 返回元素是否具有任何匹配指定名称和命名空间的属性 |
hasAttributes() | 返回元素是否具有任何属性 |
hasChildNodes() | 返回元素是否具有任何子节点 |
insertBefore() | 在现有子节点之前插入一个新的子节点 |
isDefaultNamespace(URI) | 返回指定的命名空间 URI 是否为默认命名空间 |
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 属性 |