インタフェースDocumentFragment

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

Node

public interface DocumentFragment extends Node

DocumentFragmentは、「軽量(最小限度)」のDocumentオブジェクトです。 文書ツリーから一部を抽出する機能や文書から新しいフラグメントを作成する機能は、非常に実用性の高いものです。 フラグメントを移動させて、ドキュメントのカットや再構成などを行うユーザー・コマンドの実装を想像してみてください。 このようなフラグメントを保持できるオブジェクトを持つことが望まれます。また、このような目的でノードを使用することはごく当然のことです。 Documentオブジェクトがこの役割を遂行することも可能ですが、Documentオブジェクトは、実装によって重量オブジェクトになる可能性があります。 このために実際に必要なのは、非常に軽量なオブジェクトです。 DocumentFragmentは、このようなオブジェクトです。

さらに、ノードを別のNodeの子として挿入するといったさまざまな操作では、引数としてDocumentFragmentオブジェクトが必要になることがあります。これにより、DocumentFragmentのすべての子ノードがこのノードの子リストに移動されます。

DocumentFragmentノードの子は、文書の構造を定義するすべてのサブツリーのトップを表す0個以上のノードです。 DocumentFragmentノードは、整形式のXML文書である必要はありません(ただし、複数のトップ・ノードを持つことができる整形式のXML解析対象エンティティに課せられた規則には従う必要があります)。 たとえば、DocumentFragmentが子を1つだけ持ち、その子ノードがTextノードであるとします。 このような構造モデルは、HTML文書にも整形式のXML文書にも該当しません。

DocumentFragmentがDocument (実際には、子を持つことのできるその他の任意のNode)に挿入されるとき、Nodeに挿入されるのはそのDocumentFragment自身ではなく、DocumentFragmentの子です。 これにより、ユーザーが兄弟ノードであるノードを作成しようとする場合にDocumentFragmentが非常に有効になります。ユーザーがNodeインタフェースからNode.insertBeforeやNode.appendChildなどの標準メソッドを使用できるように、DocumentFragmentはこれらのノードの親として機能します。

「Document Object Model (DOM) Level 3 Core Specification」も参照してください。

導入されたバージョン:

1.4、DOMレベル2

フィールドのサマリー

インタフェース 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

修飾子と型	フィールド	説明
static final short	ATTRIBUTE_NODE	ノードはAttrです。
static final short	CDATA_SECTION_NODE	ノードはCDATASectionです。
static final short	COMMENT_NODE	ノードはCommentです。
static final short	DOCUMENT_FRAGMENT_NODE	ノードはDocumentFragmentです。
static final short	DOCUMENT_NODE	ノードはDocumentです。
static final short	DOCUMENT_POSITION_CONTAINED_BY	ノードは参照ノードに含まれています。
static final short	DOCUMENT_POSITION_CONTAINS	ノードは参照ノードを含みます。
static final short	DOCUMENT_POSITION_DISCONNECTED	2つのノードは切断されます。
static final short	DOCUMENT_POSITION_FOLLOWING	ノードは参照ノードのあとに続きます。
static final short	DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC	先行するかあとにくるかは実装に固有です。
static final short	DOCUMENT_POSITION_PRECEDING	2番目のノードは参照ノードの前にあります。
static final short	DOCUMENT_TYPE_NODE	ノードはDocumentTypeです。
static final short	ELEMENT_NODE	ノードはElementです。
static final short	ENTITY_NODE	ノードはEntityです。
static final short	ENTITY_REFERENCE_NODE	ノードはEntityReferenceです。
static final short	NOTATION_NODE	ノードはNotationです。
static final short	PROCESSING_INSTRUCTION_NODE	ノードはProcessingInstructionです。
static final short	TEXT_NODE	ノードはTextノードです。

メソッドのサマリー

インタフェース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

修飾子と型	メソッド	説明
Node	appendChild(Node newChild)	ノードnewChildをこのノードの子のリストの末尾に追加します。
Node	cloneNode(boolean deep)	ノードのジェネリック・コピー・コンストラクタとして、このノードの複製を返します。
short	compareDocumentPosition(Node other)	このメソッドが呼び出されている参照ノードを、パラメータとして渡されるノードと、文書内の位置に関して文書順に比較します。
NamedNodeMap	getAttributes()	このノードがElementの場合、このノードの属性を含むNamedNodeMap。それ以外の場合はnull。
String	getBaseURI()	このノードの絶対ベースURI。実装が絶対URIを取得できなかった場合はnull。
NodeList	getChildNodes()	このノードの子をすべて含むNodeList。
Object	getFeature(String feature, String version)	このメソッドは、指定した機能とバージョンを持つ特殊な形式のAPIを指定されたとおりに実装する特殊な形式のオブジェクトを返します。
Node	getFirstChild()	このノードの最初の子ノードです。
Node	getLastChild()	このノードの最後の子ノードです。
String	getLocalName()	このノードの修飾名のローカル部分を返します。
String	getNamespaceURI()	このノードの名前空間URI。未指定の場合はnull。
Node	getNextSibling()	このノードの直後のノードです。
String	getNodeName()	このノードの名前です。この名前は型によって異なります。上記の表を参照してください。
short	getNodeType()	オブジェクトの型を表すコードです。上記の定義を参照してください。
String	getNodeValue()	このノードの値です。この値は型によって異なります。前述の表を参照してください。
Document	getOwnerDocument()	このノードに関連付けられたDocumentオブジェクト。
Node	getParentNode()	このノードの親ノードです。
String	getPrefix()	このノードの名前空間接頭辞です。未指定の場合はnullになります。
Node	getPreviousSibling()	このノードの直前のノードです。
String	getTextContent()	この属性は、指定されたノードとノードの子孫のテキスト・コンテンツを返します。
Object	getUserData(String key)	このノードのキーに関連付けられたオブジェクトを取得します。
boolean	hasAttributes()	このノードが要素である場合、属性を持っているかどうかを判断します。
boolean	hasChildNodes()	このノードが子ノードを持っているかどうかを判断します。
Node	insertBefore(Node newChild, Node refChild)	既存のrefChild子ノードの前にnewChildノードを挿入します。
boolean	isDefaultNamespace(String namespaceURI)	このメソッドは、指定されたnamespaceURIがデフォルトの名前空間であるかどうかをチェックします。
boolean	isEqualNode(Node arg)	2つのノードが等しいかどうかをテストします。
boolean	isSameNode(Node other)	このノードが指定されたノードと同じノードであるかどうかを返します。
boolean	isSupported(String feature, String version)	DOM実装が特定の機能を実装しており、このノードがその機能を指定されたとおりにサポートしているかどうかを判定します。
String	lookupNamespaceURI(String prefix)	指定したノードから開始して、所定の接頭辞に関連する名前空間URIを検索します。
String	lookupPrefix(String namespaceURI)	指定されたノードから開始して、所定の名前空間URIに関連する接頭辞を検索します。
void	normalize()	このNodeのサブツリーの最深部までに存在するすべてのTextノード(属性ノードを含む)を、Textノードが構造(要素、コメント、処理命令、CDATAセクション、エンティティ参照など)のみによって分離される、「正規」形式にします。その結果、隣接するTextノードも空のTextノードも存在しない状態になります。
Node	removeChild(Node oldChild)	子リストからoldChildで示される子ノードを削除し、この子ノードを返します。
Node	replaceChild(Node newChild, Node oldChild)	子リストの中の子ノードoldChildをnewChildで置き換え、oldChildノードを返します。
void	setNodeValue(String nodeValue)	このノードの値です。この値は型によって異なります。前述の表を参照してください。
void	setPrefix(String prefix)	このノードの名前空間接頭辞です。未指定の場合はnullになります。
void	setTextContent(String textContent)	この属性は、指定されたノードとノードの子孫のテキスト・コンテンツを返します。
Object	setUserData(String key, Object data, UserDataHandler handler)	このノードのキーにオブジェクトを関連付けます。