Интерфейс 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.

См. также Спецификацию Модели объекта документа (DOM) уровня 3 Core.