public interface EntityReference extends Node
EntityReference objects 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 EntityReference
objects. If it does provide such objects, then for a given
EntityReference node, it may be that there is no
Entity node representing the referenced entity. If such an
Entity exists, then the subtree of the
EntityReference node is in general a copy of the
Entity node 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 EntityReference node may be bound to
different namespace URIs.
As for Entity nodes, EntityReference nodes and
all their descendants are readonly.
See also the Document Object Model (DOM) Level 2 Core Specification.
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODEappendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefixCopyright © 2000 W3C® (MIT, INRIA, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. This document has been reviewed by W3C Members and other interested parties and has been endorsed by the Director as a W3C Recommendation.