Интерфейс DocumentFragment

public interface DocumentFragment extends Node

DocumentFragment — это "лёгкий" или "минимальный" Document объект. Часто возникает необходимость извлечь часть дерева документа или создать новый фрагмент документа. Представьте реализацию пользовательской команды, например, вырезать или переупорядочить документ, перемещая фрагменты. Для хранения таких фрагментов нужен объект, и для этой цели подходит Node. Хотя объект 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.