Интерфейс EntityReference

public interface EntityReference extends Node

EntityReference узлы могут использоваться для представления ссылки на сущность в дереве. Обратите внимание, что ссылки на символы и ссылки на предопределённые сущности считаются расширенными процессором HTML или XML, так что символы представлены своим эквивалентом Юникода, а не ссылкой на сущность. Более того, процессор XML может полностью расширить ссылки на сущности при построении Document, вместо предоставления EntityReference узлов. Если он предоставляет такие узлы, то для EntityReference узла, представляющего ссылку на известную сущность, существует Entity, и поддерево EntityReference узла является копией поддерева Entity узла. Однако это может быть неверно, когда сущность содержит не связанный префикс пространства имён. В таком случае, поскольку разрешение префикса пространства имён зависит от того, где находится ссылка на сущность, потомки EntityReference узла могут быть связаны с различными URI пространства имён. Когда EntityReference узел представляет ссылку на неизвестную сущность, у узла нет дочерних элементов, и его значение замещения, когда используется Attr.value например, пустое.

Что касается Entity узлов, EntityReference узлы и все их потомки являются только для чтения.

Примечание: EntityReference узлы могут вызвать проблемы с нормализацией содержимого элемента и значений атрибутов, например, в XML 1.0 и XML Schema, когда нормализация выполняется после расширения ссылок на сущности.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.