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

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only