CKTIS / HTML
koncept HTML: character-references
Znakové odkazy zapisujú znak názvom alebo bodom kódu, výsledok však závisí od vyhovujúcej syntaxe a stavu tokenizátora HTML.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
& | & | &Pomenovaný odkaz &, desiatkový číselný & a šestnástkový číselný & vytvoria &. Názvy rozlišujú veľkosť a číslo označuje bod kódu; nie každé číslo je povolené a neplatné rozsahy podliehajú pravidlám náhrady parsera.
Vo vyhovujúcom zdroji končí odkaz bodkočiarkou. Pre historickú kompatibilitu parser niektoré názvy obnoví, takže © sa môže zmeniť na ©, vynechanie bodkočiarky je však chyba a môže zmeniť najdlhšiu zhodu oproti ©; na obnovu sa nespoliehaj.
Hodnoty atribútov majú ďalšiu historickú výnimku: ak zhodný pomenovaný odkaz nemá bodkočiarku a nasleduje alfanumerický znak ASCII alebo znamienko rovnosti, zhoda sa nespotrebuje. Preto &x a &=1 zostanú v atribúte doslovné, kým &=2 dekóduje ampersand. Surový obsah <script> a <style> nepoužíva znakové odkazy na únik.
Príklad v bežnom texte dekóduje &, &, &, historické © a úplné ∉; porovnáva aj textové &x a &=1 s doslovnými hodnotami atribútu &x a &=1. Ukončené &=2 sa tam dekóduje, kým surový štýl zachová &.
Príklady
<!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>
Výsledok
text=&|&|&|©|∉|&x|&=1; attribute=&x|&=1|&=2; raw=.x::before{content:"&"}Spustený príklad potvrdzuje pomenované a číselné formy aj výnimku iba pre hodnoty atribútov, keď po názve bez bodkočiarky nasleduje alfanumerický znak ASCII alebo znamienko rovnosti.