public interface EntityReference extends Node
EntityReferenceobjects may be inserted into the structure model when an entity reference is in the source document, or when the user wishes to insert an entity reference. Note that character references and references to predefined entities are considered to be expanded by the HTML or XML processor so that characters are represented by their Unicode equivalent rather than by an entity reference. Moreover, the XML processor may completely expand references to entities while building the structure model, instead of providing
EntityReferenceobjects. If it does provide such objects, then for a given
EntityReferencenode, it may be that there is no
Entitynode representing the referenced entity. If such an
Entityexists, then the subtree of the
EntityReferencenode is in general a copy of the
Entitynode subtree. However, this may not be true when an entity contains an unbound namespace prefix. In such a case, because the namespace prefix resolution depends on where the entity reference is, the descendants of the
EntityReferencenode may be bound to different namespace URIs.
EntityReference nodes and
all their descendants are readonly.
See also the Document Object Model (DOM) Level 2 Core Specification.
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix