EntityReference in DOM Level 2 Core
The EntityReference interface represents an entity reference in the source document.
For more information see http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-11C98490.
Inherits from:
Instance Properties
| name | type | description |
|---|---|---|
| attributes | NamedNodeMap | (read only) [from Node] |
| childNodes | NodeList | (read only) [from Node] |
| firstChild | Node | (read only) [from Node] |
| lastChild | Node | (read only) [from Node] |
| localName | String | (read only) [from Node] |
| namespaceURI | String | (read only) [from Node] |
| nextSibling | Node | (read only) [from Node] |
| nodeName | String | (read only) [from Node] |
| nodeType | Number | (read only) [from Node] |
| nodeValue | String | [from Node] |
| ownerDocument | Document | (read only) [from Node] |
| parentNode | Node | (read only) [from Node] |
| prefix | String | [from Node] |
| previousSibling | Node | (read only) [from Node] |
Instance Methods
| name | returns | description |
|---|---|---|
| addEventListener(type,listener,useCapture) | (none) | [from EventTarget] |
| appendChild(newChild) | Node | [from Node] |
| cloneNode(deep) | Node | Return a new copy of the node. [from Node] |
| dispatchEvent(evt) | Boolean | Dispatches an event to the invoking object. [from EventTarget] |
| hasAttributes() | Boolean | [from Node] |
| hasChildNodes() | Boolean | [from Node] |
| insertBefore(newChild,refChild) | Node | [from Node] |
| isSupported(feature,version) | Boolean | [from Node] |
| normalize() | (none) | [from Node] |
| removeChild(oldChild) | Node | [from Node] |
| removeEventListener(type,listener,useCapture) | (none) | [from EventTarget] |
| replaceChild(newChild,oldChild) | Node | [from Node] |
Description
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.
Methods that return a EntityReference
| name | of object | description |
|---|---|---|
| createEntityReference(name) | Document |