Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

koncept HTML: character-references

Znakové odkazy zapisují znak názvem nebo bodem kódu, výsledek však závisí na vyhovující syntaxi a stavu tokenizátoru HTML.

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

Syntaxe

& | & | &

Pojmenovaný odkaz &, desetinný číselný & a šestnáctkový číselný & vytvoří &. Názvy rozlišují velikost a číslo označuje bod kódu; ne každé číslo je povoleno a neplatné rozsahy podléhají pravidlům náhrady parseru.

Ve vyhovujícím zdroji končí odkaz středníkem. Kvůli historické kompatibilitě parser některé názvy obnoví, takže &copy se může změnit na ©, vynechání středníku je však chyba a může změnit nejdelší shodu oproti ©; na obnovu nespoléhej.

Hodnoty atributů mají další historickou výjimku: pokud shodný pojmenovaný odkaz nemá středník a následuje alfanumerický znak ASCII nebo rovnítko, shoda se nespotřebuje. Proto &ampx a &amp=1 zůstanou v atributu doslovné, zatímco &amp;=2 dekóduje ampersand. Surový obsah <script> a <style> nepoužívá znakové odkazy k úniku.

Příklad v běžném textu dekóduje &amp;, &#38;, &#x26;, historické &copy a úplné &notin;; také porovnává textové &ampx a &amp=1 s doslovnými hodnotami atributu &ampx a &amp=1. Ukončené &amp;=2 se tam dekóduje, zatímco surový styl zachová &amp;.

Příklady

<!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>

Výsledek

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

Spuštěný příklad potvrzuje pojmenované a číselné formy i výjimku pouze pro hodnoty atributů, když po názvu bez středníku následuje alfanumerický znak ASCII nebo rovnítko.

Zdroje