TOC PREV NEXT INDEX

Put your logo here!


createDocumentFragment


createDocumentFragment creates an empty document fragment

Syntax

documentFragment = element.createDocumentFragment 

Parameters

documentFragment is an object.

Example

frag = document.createDocumentFragment(); 
frag.write("<div>Moveable Div</div>"); 

Notes

A documentFragment is a "lightweight" or "minimal" document object. It is very common to want to be able to extract a portion of a document's tree or to create a new fragment of a document. Imagine implementing a user command like cut or rearranging a document by moving fragments around. It is desirable to have an object which can hold such fragments and it is quite natural to use a Node for this purpose.

While it is true that a document object could fulfill this role, a document object can potentially be a heavyweight object, depending on the underlying implementation. What is really needed for this is a very lightweight object. documentFragment is such an object.

Specification

core


mozilla.org | mailto:oeschger | bug 93108
TOC PREV NEXT INDEX