CKTIS / HTML
HTML-concept: character-references
Tekenreferenties schrijven een teken via naam of codepunt, maar het resultaat hangt af van conforme syntaxis en de toestand van de HTML-tokenizer.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
& | & | &De benoemde &, decimaal numerieke & en hexadecimaal numerieke & produceren allemaal &. Namen zijn hoofdlettergevoelig en het getal duidt een codepunt aan; niet elk getal is toegestaan en ongeldige bereiken volgen de vervangingsregels van de parser.
In conforme broncode eindigt een referentie met een puntkomma. Voor historische compatibiliteit herstelt de parser sommige namen, zodat © © kan worden, maar de puntkomma weglaten is een fout en kan de langste overeenkomst ten opzichte van © wijzigen; vertrouw niet op herstel.
Attribuutwaarden hebben een extra historische uitzondering: als een gevonden benoemde referentie geen puntkomma heeft en het volgende teken een ASCII-alfanumeriek teken of gelijkteken is, wordt de overeenkomst niet verbruikt. Daarom blijven &x en &=1 letterlijk in het attribuut, terwijl &=2 de ampersand decodeert. Ruwe inhoud van <script> en <style> gebruikt tekenreferenties niet als ontsnapping.
Het voorbeeld decodeert &, &, &, het historische © en het volledige ∉ in gewone tekst; het vergelijkt ook de teksten &x en &=1 met de letterlijke attribuutwaarden &x en &=1. Het afgesloten &=2 wordt daar gedecodeerd, terwijl ruwe stijltekst & behoudt.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<output id="result"></output>
<script>
const markup = "<p id=text>&|&|&|©|∉|&x|&=1</p><p id=attr data-value=\"&x|&=1|&=2\"></p><style id=raw>.x::before{content:\"&\"}</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>
Resultaat
text=&|&|&|©|∉|&x|&=1; attribute=&x|&=1|&=2; raw=.x::before{content:"&"}Het uitgevoerde voorbeeld bevestigt benoemde en numerieke vormen en de uitzondering die alleen voor attribuutwaarden geldt wanneer een ASCII-alfanumeriek teken of gelijkteken op een naam zonder puntkomma volgt.