Интерфейс DocumentFragment

Все суперинтерфейсы:: Node

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, допускающий дочерние узлы) в Node вставляются дочерние узлы DocumentFragment, а не сам DocumentFragment. Это делает DocumentFragment очень полезным, когда пользователь хочет создать узлы-соседи; DocumentFragment выступает родителем этих узлов, позволяя пользователю использовать стандартные методы интерфейса Node, такие как Node.insertBefore и Node.appendChild.

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

Начиная с версии:: 1.4, DOM Level 2

Краткое описание полей

Поля, объявленные в интерфейсе Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Модификатор и тип	Поле	Описание
`static final short`	`ATTRIBUTE_NODE`	Узел является `Attr`.
`static final short`	`CDATA_SECTION_NODE`	Узел является `CDATASection`.
`static final short`	`COMMENT_NODE`	Узел является `Comment`.
`static final short`	`DOCUMENT_FRAGMENT_NODE`	Узел является `DocumentFragment`.
`static final short`	`DOCUMENT_NODE`	Узел является `Document`.
`static final short`	`DOCUMENT_POSITION_CONTAINED_BY`	Узел содержится в опорном узле.
`static final short`	`DOCUMENT_POSITION_CONTAINS`	Узел содержит опорный узел.
`static final short`	`DOCUMENT_POSITION_DISCONNECTED`	Два узла не связаны.
`static final short`	`DOCUMENT_POSITION_FOLLOWING`	Узел следует за опорным узлом.
`static final short`	`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC`	Определение того, какой узел предшествует другому, зависит от реализации.
`static final short`	`DOCUMENT_POSITION_PRECEDING`	Второй узел предшествует опорному узлу.
`static final short`	`DOCUMENT_TYPE_NODE`	Узел является `DocumentType`.
`static final short`	`ELEMENT_NODE`	Узел является `Element`.
`static final short`	`ENTITY_NODE`	Узел является `Entity`.
`static final short`	`ENTITY_REFERENCE_NODE`	Узел является `EntityReference`.
`static final short`	`NOTATION_NODE`	Узел является `Notation`.
`static final short`	`PROCESSING_INSTRUCTION_NODE`	Узел является `ProcessingInstruction`.
`static final short`	`TEXT_NODE`	Узел является узлом `Text`.

Краткое описание методов

Методы, объявленные в интерфейсе Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Модификатор и тип	Метод	Описание
`Node`	`appendChild(Node newChild)`	Добавляет узел `newChild` в конец списка дочерних узлов этого узла.
`Node`	`cloneNode(boolean deep)`	Возвращает копию этого узла, то есть служит универсальным конструктором копирования узлов.
`short`	`compareDocumentPosition(Node other)`	Сравнивает опорный узел (узел, для которого вызывается этот метод) с другим узлом (переданным в качестве параметра) по их положению в документе и в соответствии с порядком документа.
`NamedNodeMap`	`getAttributes()`	Объект `NamedNodeMap`, содержащий атрибуты этого узла (если это `Element`), или `null` в противном случае.
`String`	`getBaseURI()`	Абсолютный базовый URI этого узла или `null`, если реализации не удалось получить абсолютный URI.
`NodeList`	`getChildNodes()`	Объект `NodeList`, содержащий все дочерние узлы этого узла.
`Object`	`getFeature(String feature, String version)`	Этот метод возвращает специализированный объект, реализующий специализированные API указанной функции и версии, как описано в .
`Node`	`getFirstChild()`	Первый дочерний узел этого узла.
`Node`	`getLastChild()`	Последний дочерний узел этого узла.
`String`	`getLocalName()`	Возвращает локальную часть квалифицированного имени этого узла.
`String`	`getNamespaceURI()`	URI пространства имён этого узла или `null`, если он не указан (см. ).
`Node`	`getNextSibling()`	Узел, непосредственно следующий за этим узлом.
`String`	`getNodeName()`	Имя этого узла в зависимости от его типа; см. таблицу выше.
`short`	`getNodeType()`	Код, представляющий тип базового объекта, как определено выше.
`String`	`getNodeValue()`	Значение этого узла в зависимости от его типа; см. таблицу выше.
`Document`	`getOwnerDocument()`	Объект `Document`, связанный с этим узлом.
`Node`	`getParentNode()`	Родитель этого узла.
`String`	`getPrefix()`	Префикс пространства имён этого узла или `null`, если он не указан.
`Node`	`getPreviousSibling()`	Узел, непосредственно предшествующий этому узлу.
`String`	`getTextContent()`	Этот атрибут возвращает текстовое содержимое этого узла и его потомков.
`Object`	`getUserData(String key)`	Извлекает объект, связанный с ключом в этом узле.
`boolean`	`hasAttributes()`	Возвращает, есть ли у этого узла атрибуты (если он является элементом).
`boolean`	`hasChildNodes()`	Возвращает, есть ли у этого узла дочерние узлы.
`Node`	`insertBefore(Node newChild, Node refChild)`	Вставляет узел `newChild` перед существующим дочерним узлом `refChild`.
`boolean`	`isDefaultNamespace(String namespaceURI)`	Этот метод проверяет, является ли указанный `namespaceURI` пространством имён по умолчанию.
`boolean`	`isEqualNode(Node arg)`	Проверяет, равны ли два узла.
`boolean`	`isSameNode(Node other)`	Возвращает, является ли этот узел тем же самым узлом, что и указанный.
`boolean`	`isSupported(String feature, String version)`	Проверяет, реализует ли DOM-реализация определённую функцию и поддерживается ли эта функция данным узлом, как описано в .
`String`	`lookupNamespaceURI(String prefix)`	Ищет URI пространства имён, связанный с указанным префиксом, начиная с этого узла.
`String`	`lookupPrefix(String namespaceURI)`	Ищет префикс, связанный с указанным URI пространства имён, начиная с этого узла.
`void`	`normalize()`	Приводит все узлы `Text` на всей глубине поддерева этого `Node`, включая узлы-атрибуты, к «нормальной» форме, в которой узлы `Text` разделяются только структурными элементами (например, элементами, комментариями, инструкциями по обработке, разделами CDATA и ссылками на сущности); таким образом, отсутствуют соседние узлы `Text` и пустые узлы `Text`.
`Node`	`removeChild(Node oldChild)`	Удаляет дочерний узел, указанный параметром `oldChild`, из списка дочерних узлов и возвращает его.
`Node`	`replaceChild(Node newChild, Node oldChild)`	Заменяет дочерний узел `oldChild` на `newChild` в списке дочерних узлов и возвращает узел `oldChild`.
`void`	`setNodeValue(String nodeValue)`	Значение этого узла в зависимости от его типа; см. таблицу выше.
`void`	`setPrefix(String prefix)`	Префикс пространства имён этого узла или `null`, если он не указан.
`void`	`setTextContent(String textContent)`	Этот атрибут возвращает текстовое содержимое этого узла и его потомков.
`Object`	`setUserData(String key, Object data, UserDataHandler handler)`	Связывает объект с ключом в этом узле.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.