Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

concept HTML: character-references

Les références de caractères écrivent un caractère par nom ou point de code, mais le résultat dépend d’une syntaxe conforme et de l’état du tokenizer HTML.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

& | & | &

La référence nommée &, la numérique décimale & et la numérique hexadécimale & produisent toutes &. Les noms sont sensibles à la casse et le nombre désigne un point de code ; tous les nombres ne sont pas permis et les plages invalides suivent les règles de remplacement du parseur.

Dans une source conforme, la référence finit par un point-virgule. Pour compatibilité historique, le parseur récupère certains noms : &copy peut devenir ©, mais omettre le point-virgule est une erreur et peut changer le plus long appariement par rapport à © ; ne comptez jamais sur cette récupération.

Les valeurs d’attribut ont une exception historique supplémentaire : si une référence nommée appariée n’a pas de point-virgule et que le caractère suivant est alphanumérique ASCII ou un signe égal, l’appariement n’est pas consommé. Ainsi &ampx et &amp=1 restent littéraux dans l’attribut, tandis que &amp;=2 décode l’esperluette. Le contenu brut de <script> et <style> n’emploie pas les références comme échappement.

L’exemple décode &amp;, &#38;, &#x26;, l’historique &copy et le complet &notin; dans le texte ordinaire ; il compare aussi les textes &ampx et &amp=1 aux valeurs d’attribut littérales &ampx et &amp=1. Le &amp;=2 terminé y est décodé, tandis que le style brut conserve &amp;.

Exemples

<!doctype html>
<meta charset="utf-8">
<output id="result"></output>
<script>
const markup = "<p id=text>&amp;|&#38;|&#x26;|&copy|&notin;|&ampx|&amp=1</p><p id=attr data-value=\"&ampx|&amp=1|&amp;=2\"></p><style id=raw>.x::before{content:\"&amp;\"}</style>";
const parsed = new DOMParser().parseFromString(markup, "text/html");
const textValue = parsed.querySelector("#text").textContent;
const attributeValue = parsed.querySelector("#attr").dataset.value;
const rawValue = parsed.querySelector("#raw").textContent;
result.textContent = `text=${textValue}; attribute=${attributeValue}; raw=${rawValue}`;
</script>

Résultat

text=&|&|&|©|∉|&x|&=1; attribute=&ampx|&amp=1|&=2; raw=.x::before{content:"&amp;"}

L’exemple exécuté confirme les formes nommées et numériques ainsi que l’exception propre aux valeurs d’attribut lorsqu’un caractère alphanumérique ASCII ou un signe égal suit un nom sans point-virgule.

Sources