Интерфейс 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 Core.