Document.createDocumentFragment()

空の DocumentFragment を新しく作成します。

構文

var fragment = document.createDocumentFragment();

fragment には作成された空の DocumentFragment オブジェクトへの参照が代入されます。

解説

DocumentFragment は DOM ノードです。メインの DOM ツリーの一部にはなりません。通常の使い方は、文書フラグメントを生成し、その文書フラグメントに要素を追加して、その文書フラグメントを DOM ツリーへ追加します。 DOM ツリー内では、文書フラグメントはすべての子要素によって置き換えられます。

文書フラグメントはメモリ内にあり、メインの DOM ツリーの一部ではないため、文書フラグメントに子要素を追加してもページのリフロー (要素の位置と大きさを決定するための計算) が行われません。そのため文書フラグメントを利用することによって、パフォーマンスの改善が見込まれます。

例

この例は主要なウェブブラウザーのリストを作成します。

HTML

<ul id="ul">
</ul>

JavaScript

var element  = document.getElementById('ul'); // ul があることを仮定
var fragment = document.createDocumentFragment();
var browsers = ['Firefox', 'Chrome', 'Opera', 
    'Safari', 'Internet Explorer'];

browsers.forEach(function(browser) {
    var li = document.createElement('li');
    li.textContent = browser;
    fragment.appendChild(li);
});

element.appendChild(fragment);

結果

仕様書

ブラウザーの対応

関連情報

• document.implementation.createDocument()
• documentFragment