Интерфейс 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) уровня 3.