JavaTM 2 Platform
Standard Ed. 5.0

org.w3c.dom
インタフェース DocumentFragment

すべてのスーパーインタフェース:
Node

public interface DocumentFragment
extends Node

DocumentFragment は、「軽量 (最小限度)」 の Document オブジェクトです。文書ツリーから一部を抽出する機能や文書から新しいフラグメントを作成する機能は、非常に実用性の高いものです。たとえば、文書のフラグメントの切り取りや再配置を行うユーザコマンドを実装する際、フラグメントを格納できるオブジェクトがあれば便利です。そこでよく使用されるのが Node です。Node の代わりに Document オブジェクトを使用することもできますが、このオブジェクトには、実装によって重量オブジェクトになり得るという問題があります。もっともニーズに合った最軽量のオブジェクトは、DocumentFragment オブジェクトです。

DocumentFragment オブジェクトは、このほかにもさまざまな用途で使用されます。たとえば、別の Node の子としてノードを挿入する場合、DocumentFragment オブジェクトを引数として取り、この結果、DocumentFragment の子ノード全部が挿入されるノードの子リストに移動します。

DocumentFragment ノードの子ノードは、文書の構造を定義するサブツリーのトップに位置する 0 個以上のノードです。DocumentFragment ノードは、整形式の XML 文書でなくてもかまいませんが、整形式の XML 解析エンティティ (複数のトップノードを持つことができる) でなければなりません。たとえば、DocumentFragment ノードの子ノードとして、Text ノードを 1 つだけ持たせることができます。このような構造モデルは、HTML 文書にも整形式の XML 文書にも該当しません。

DocumentFragmentDocument (あるいは、子を持たせることができるその他の Node) に挿入する際、実際に Node に挿入されるのは、DocumentFragment ではなく DocumentFragment の子になります。この機能は、兄弟ノードを作成する場合に非常に便利です。というのは、DocumentFragment がこれらのノードの親になるため、Node.insertBeforeNode.appendChild といった Node インタフェースの標準メソッドを使用できるからです。

「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. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。