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

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