Интерфейс DocumentFragment

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.