CKTIS / HTML
HTML концепция: character-references
Знаковите препратки записват знак чрез име или кодова точка, но резултатът зависи от съответстващ синтаксис и състоянието на HTML токенизатора.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
& | & | &Именуваната препратка &, десетичната числова & и шестнадесетичната числова & дават &. Имената различават регистъра, а числото означава кодова точка; не всяко число е позволено и невалидните диапазони следват правилата за замяна на анализатора.
В съответстващ източник препратката завършва с точка и запетая. За историческа съвместимост анализаторът възстановява някои имена, така че © може да стане ©, но пропускането на точката и запетаята е грешка и може да промени най-дългото съвпадение спрямо ©; не разчитайте на възстановяването.
Стойностите на атрибути имат допълнително историческо изключение: ако съвпадналата именувана препратка няма точка и запетая и следващият знак е ASCII буква или цифра, или знак за равенство, съвпадението не се консумира. Затова &x и &=1 остават буквални в атрибута, а &=2 декодира амперсанда. Суровото съдържание на <script> и <style> не използва знакови препратки за екраниране.
Примерът декодира в обикновен текст &, &, &, историческото © и пълното ∉; сравнява и текстовите &x и &=1 с буквалните стойности на атрибута &x и &=1. Завършеното &=2 се декодира там, а суровият стил запазва &.
Примери
<!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>
Резултат
text=&|&|&|©|∉|&x|&=1; attribute=&x|&=1|&=2; raw=.x::before{content:"&"}Изпълненият пример потвърждава именуваните и числовите форми и изключението само за стойности на атрибути, когато след име без точка и запетая има ASCII буква или цифра, или знак за равенство.