JavaTM 2 Platform
Standard Ed. 6

org.w3c.dom
接口 DocumentFragment

所有超级接口:
Node

public interface DocumentFragment
extends Node

DocumentFragment 是“轻量级”或“最小”Document 对象。希望能够提取文档树的一部分或创建文档的新片段是很常见的。设想实现像剪切这样的用户命令或通过来回移动片段重新安排文档。需要有一个可以保存此类片段的对象,很自然出于此目要使用一个 Node。当 Document 对象真正可以完成此职责时,Document 对象可能为重量级对象,具体取决于基础实现。此操作真正需要的是非常轻量级的对象。DocumentFragment 就是这样的对象。

此外,多种操作(如作为另一个 Node 的子节点插入节点)可能将 DocumentFragment 对象作为参数;这样会导致将 DocumentFragment 的所有子节点移动到此节点的子列表。

DocumentFragment 节点的子节点为 0 或表示定义文档结构的所有子树顶部的多个节点。DocumentFragment 节点不需要是格式良好的 XML 文档(尽管它们需要遵循强加给格式良好的 XML 已解析实体的规则,这些实体可以有多个顶部节点)。例如,DocumentFragment 可能只有一个子节点,并且该子节点可以是 Text。这样的结构模型表示的既不是 HTML 文档,也不是格式良好的 XML 文档。

DocumentFragment 插入 Document(确切地说是可以接受子节点的任何其他 Node)时,将 DocumentFragment 的子节点而不是将 DocumentFragment 本身插入 Node。这使得 DocumentFragment 在用户希望创建兄弟节点时非常有用;该 DocumentFragment 充当这些节点的父节点,所以用户可以使用 Node 接口中的标准方法,如 Node.insertBeforeNode.appendChild

另请参见 Document Object Model (DOM) Level 3 Core Specification


字段摘要
 
从接口 org.w3c.dom.Node 继承的字段
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
方法摘要
 
从接口 org.w3c.dom.Node 继承的方法
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 


JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策