Интерфейс 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 нормализация выполняется после расширения ссылок на сущности.

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