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