Интерфейс DocumentFragment

public interface DocumentFragment
extends Node

DocumentFragment — это «лёгкий» или «минимальный» Document объект. Часто требуется извлечь часть дерева документа или создать новый фрагмент. Представьте реализацию команды пользователя, например, «вырезать» или «перегруппировать» документ, перемещая фрагменты. Необходимо иметь объект, который может хранить такие фрагменты, и для этой цели вполне подходит Узел. Хотя объект Document мог бы выполнить эту роль, объект Document потенциально может быть тяжёлым объектом в зависимости от реализации. Для этого требуется очень лёгкий объект. DocumentFragment — это такой объект.

Кроме того, различные операции, такие как вставка узлов в качестве потомков другого Node, могут принимать объекты DocumentFragment, в результате чего все дочерние узлы DocumentFragment перемещаются в список потомков этого узла.

Потомки узла DocumentFragment — это ноль или более узлов, представляющих вершины любых поддеревьев, определяющих структуру документа. Узлы DocumentFragment не обязаны быть хорошо сформированными XML-документами (хотя они должны соблюдать правила, налагаемые на хорошо сформированные парсируемые сущности XML, которые могут иметь несколько узлов верхнего уровня). Например, у DocumentFragment может быть только один потомок, и этот дочерний узел может быть узлом Text. Такая структура не представляет ни HTML-документ, ни хорошо сформированный XML-документ.

При вставке DocumentFragment в Document (или, в общем, в любой другой Node, принимающий потомков), вставляются потомки DocumentFragment, а не сам DocumentFragment в Node. Это делает DocumentFragment очень полезным, когда пользователь хочет создать узлы-потомки; DocumentFragment выступает в качестве родителя этих узлов, так что пользователь может использовать стандартные методы интерфейса Node, такие как Node.insertBefore и Node.appendChild.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.