L'interface EntityReference représente une référence d'entité.

é

Les références de caractères ou d'entités prédéfinies sont considérées comme développées par le processeur HTML ou XML, de telle sorte que les caractères sont représentés par leur code Unicode équivalent plutôt que par une référence d'entité.

En XML, les références d'entités possèdent chacun une déclaration d'entité au sein de la définition de type de document. Les déclarations d'entité forment un dictionnaire sur lequel le processeur XML pourra s'appuyer pour traduire les références d'entités contenues dans le document.

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<!DOCTYPE poeme [
  <!ENTITY Agrave "À">
  <!ENTITY Aacute "Á">
  <!ENTITY Acirc "Â">
  <!ENTITY AElig "Æ">
  <!ENTITY Ccedil "Ç">
  <!ENTITY Egrave "È">
  <!ENTITY Eacute "É">
  <!ENTITY Ecirc "Ê">
  <!ENTITY Igrave "Ì">
  <!ENTITY Iacute "Í">
  <!ENTITY Icirc "Î">
  <!ENTITY Ograve "Ò">
  <!ENTITY Oacute "Ó">
  <!ENTITY Ocirc "Ô">
  <!ENTITY Ugrave "Ù">
  <!ENTITY Uacute "Ú">
  <!ENTITY Ucirc "Û">
  <!ENTITY agrave "à">
  <!ENTITY aacute "á">
  <!ENTITY acirc "â">
  <!ENTITY aelig "æ">
  <!ENTITY ccedil "ç">
  <!ENTITY egrave "è">
  <!ENTITY eacute "é">
  <!ENTITY ecirc "ê">
  <!ENTITY igrave "ì">
  <!ENTITY iacute "í">
  <!ENTITY icirc "î">
  <!ENTITY ograve "ò">
  <!ENTITY oacute "ó">
  <!ENTITY ocirc "ô">
  <!ENTITY ugrave "ù">
  <!ENTITY uacute "ú">
  <!ENTITY ucirc "û">
  <!ELEMENT poeme (#PCDATA)>
  <!ATTLIST poeme xml:space (preserve|default) "default">
]>
<poeme xml:space="preserve">
  &Agrave; quatre heures du matin, l'&eacute;t&eacute;,
  Le soleil d'amour dure encore.
  Sous les bocages s'&eacute;vapore
  L'odeur du soir f&ecirc;t&eacute;.

  L&agrave;-bas, dans leur vaste chantier
  Au soleil des Hesp&eacute;rides,
  D&eacute;j&agrave; s'agitent - en bras de chemise -
  Les charpentiers.

  Dans leurs D&eacute;serts de mousse, tranquilles,
  Ils pr&eacute;parent les lambris pr&eacute;cieux
  O&ugrave; la ville
  Peindra de faux cieux.

  &Ocirc;, pour ces Ouvriers charmants
  Sujets d'un roi de Babylone
  V&eacute;nus ! quitte un instant les Amants
  Dont l'&acirc;me est en couronne.

  &Ocirc; Reine des Bergers,
  Porte aux travailleurs l'eau-de-vie,
  Que leur force soient en paix
  En attendant le bain la mer &agrave; midi.
</poeme>

D'ailleurs, le processeur XML peut complètement développer les références d'entités au moment du développement du document, à la place de fournir les noeuds EntityReference.

Lorsqu'un noeud EntityReference représente une référence à une entité inconnue, le noeud n'a pas d'enfant et sa valeur de remplacement est vide.

L'interface EntityReference étend l'interface Node. Ainsi, les champs et attributs de l'interface Node sont tous disponibles à partir d'une référence d'entité.

Champ
Description
Les champs hérités de l'interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Méthode
Description
Les méthodes héritées de l'interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData