DocumentFragment

DocumentFragment インタフェースは、親ノードの無い最小限度の文書オブジェクトを表します。整形式の、または潜在的に整形式でない XML の 断片を保持するために Document の軽量版として使われます。

他のいくつかのメソッドが document fragment を引数として取ることができます（例えば、すべての Node.appendChild や Node.insertBefore のような Node インタフェースのメソッド）が、その場合に追加/挿入されるのは断片の子要素であって、断片自身ではありません。

このインタフェースは Web コンポーネントでも大いに役に立っています。<template> 要素はその HTMLTemplateElement.content 属性に DocumentFragment を含みます。

空の DocumentFragment は document.createDocumentFragment メソッドやコンストラクタを使って作成できます。

プロパティ

このインタフェースには固有の属性はありませんが、その親である Node の属性を継承し、ParentNode インタフェースの属性を実装しています。

ParentNode.children 読取専用

DocumentFragment オブジェクトの子である型 Node のすべてのオブジェクトを含む、「生」の HTMLCollection を返します。

ParentNode.firstElementChild 読取専用

DocumentFragment オブジェクトの最初の子である Element、または無ければ null を返します。

ParentNode.lastElementChild 読取専用

DocumentFragment オブジェクトの最後の子である Element、または無ければ null を返します。

ParentNode.childElementCount 読取専用

DocumentFragment が持つ子の数を表す unsigned long を返します。

コンストラクタ

DocumentFragment()

空の DocumentFragment オブジェクトを返します。

メソッド

このインタフェースはその親である Node のメソッドを継承し、ParentNode インタフェースのメソッドを実装します。

DocumentFragment.find()

DocumentFragment のツリーにある最初の見つかった Element を返します。

DocumentFragment.findAll()

DocumentFragment のツリーにある見つかった Element の NodeList を返します。

DocumentFragment.querySelector()

指定されたセレクタにマッチする、DocumentFragmentの中で文書の順序で最初の Element ノードを返します。

DocumentFragment.querySelectorAll()

指定されたセレクタにマッチする DocumentFragment の中のすべての Element ノードの NodeList を返します。

DocumentFragment.getElementById()

指定された ID にマッチする、DocumentFragment の中で文書の順序で最初の Element ノードを返します。

仕様

ブラウザ実装状況

関連情報

• DOM インタフェースの目次。