Most visited

Recently visited

Results for

Added in API level 1

Summary: Inherited Constants | Inherited Methods | [Expand All]

DocumentFragment

public interface DocumentFragment
implements Node

org.w3c.dom.DocumentFragment

DocumentFragment是一个“轻量级”或“最小” Document对象。想要能够提取文档树的一部分或创建文档的新片段是非常常见的。想象一下，通过移动碎片来执行用户命令，例如剪切或重新排列文档。希望有一个可以容纳这种碎片的物体，为此目的使用一个节点是很自然的。虽然Document对象确实可以实现此角色，但Document对象可能是重量级对象，具体取决于底层实现。真正需要的是一个非常轻量级的对象。 DocumentFragment就是这样一个对象。

此外，各种操作 - 例如将节点插入另一个Node子节点 - 可能需要DocumentFragment对象作为参数; 这会导致DocumentFragment所有子节点被移动到此节点的子节点列表中。

DocumentFragment节点的子节点是零个或多个节点，表示定义文档结构的任何子树的顶部。 DocumentFragment节点不需要是格式良好的XML文档（尽管它们确实需要遵循强制形成的XML解析实体（可能有多个顶层节点）的规则）。例如，一个DocumentFragment可能只有一个孩子，并且该子节点可能是一个Text节点。这样的结构模型既不代表HTML文档，也不代表格式良好的XML文档。

当DocumentFragment插入Document （或任何其他Node ，可能需要子女）的子女DocumentFragment ，而不是DocumentFragment本身插入Node 。当用户希望创建兄弟节点时，这使得DocumentFragment非常有用; DocumentFragment充当这些节点的父节点，以便用户可以使用Node接口中的标准方法，例如Node.insertBefore和Node.appendChild 。

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

Summary

Inherited constants

From interface org.w3c.dom.Node

Inherited methods

From interface org.w3c.dom.Node

`abstract Node`	`appendChild(Node newChild)` 将节点 `newChild`添加到此节点的子节点列表的末尾。
`abstract Node`	`cloneNode(boolean deep)` 返回此节点的副本，即充当节点的通用拷贝构造函数。
`abstract short`	`compareDocumentPosition(Node other)` 比较参考节点，即
`abstract NamedNodeMap`	`getAttributes()` 包含此节点的属性的 `NamedNodeMap` （如果它是 `Element` ）或 `null`否则。
`abstract String`	`getBaseURI()` 如果实现无法获取绝对URI，则此节点的绝对基本URI或 `null` 。
`abstract NodeList`	`getChildNodes()` 包含此节点的所有子节点的 `NodeList` 。
`abstract Object`	`getFeature(String feature, String version)` 此方法返回一个专用对象，该对象实现指定功能和版本的专用API，如中指定。
`abstract Node`	`getFirstChild()` 这个节点的第一个孩子。
`abstract Node`	`getLastChild()` 这个节点的最后一个孩子。
`abstract String`	`getLocalName()` 返回此节点的限定名称的本地部分。
`abstract String`	`getNamespaceURI()` 该节点的名称空间URI，如果未指定， `null` （请参阅 `null` ）。
`abstract Node`	`getNextSibling()` 节点紧跟在此节点之后。
`abstract String`	`getNodeName()` 该节点的名称取决于其类型; 见上表。
`abstract short`	`getNodeType()` 如上定义的代表底层对象类型的代码。
`abstract String`	`getNodeValue()` 此节点的值取决于其类型; 见上表。
`abstract Document`	`getOwnerDocument()` 与此节点关联的 `Document`对象。
`abstract Node`	`getParentNode()` 此节点的父节点。
`abstract String`	`getPrefix()` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract Node`	`getPreviousSibling()` 该节点之前的节点。
`abstract String`	`getTextContent()` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`getUserData(String key)` 检索与此节点上的键关联的对象。
`abstract boolean`	`hasAttributes()` 返回此节点（如果它是元素）是否具有任何属性。
`abstract boolean`	`hasChildNodes()` 返回此节点是否有任何子节点。
`abstract Node`	`insertBefore(Node newChild, Node refChild)` 插入节点 `newChild`现有的子节点之前 `refChild` 。
`abstract boolean`	`isDefaultNamespace(String namespaceURI)` 此方法检查指定的 `namespaceURI`是否是默认名称空间。
`abstract boolean`	`isEqualNode(Node arg)` 测试两个节点是否相等。
`abstract boolean`	`isSameNode(Node other)` 返回此节点是否与给定节点相同。
`abstract boolean`	`isSupported(String feature, String version)` 测试DOM实现是否实现了特定的功能，该功能是否受此节点支持，如指定。
`abstract String`	`lookupNamespaceURI(String prefix)` 从该节点开始查找与给定前缀关联的命名空间URI。
`abstract String`	`lookupPrefix(String namespaceURI)` 从该节点开始查找与给定名称空间URI关联的前缀。
`abstract void`	`normalize()` 将包含属性节点的此 `Node`下的子树的全部深度中的所有 `Text`节点置于“正常”形式，其中只有结构（例如元素，注释，处理指令，CDATA节和实体引用）将 `Text`节点，即既没有相邻的 `Text`节点，也没有空的 `Text`节点。
`abstract Node`	`removeChild(Node oldChild)` 从子项列表中删除由 `oldChild`指示的子节点，并将其返回。
`abstract Node`	`replaceChild(Node newChild, Node oldChild)` 替换子节点 `oldChild`与 `newChild`儿童的名单，并返回 `oldChild`节点。
`abstract void`	`setNodeValue(String nodeValue)` 此节点的值取决于其类型; 见上表。
`abstract void`	`setPrefix(String prefix)` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract void`	`setTextContent(String textContent)` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`setUserData(String key, Object data, UserDataHandler handler)` 将对象与此节点上的键相关联。