Интерфейс EntityReference

public interface EntityReference
extends Node

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

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

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

См. также Спецификацию Документ-объектной модели (DOM) Level 3 Core.