База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

HTML концепция: character-references

Знаковите препратки записват знак чрез име или кодова точка, но резултатът зависи от съответстващ синтаксис и състоянието на HTML токенизатора.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

& | & | &

Именуваната препратка &, десетичната числова & и шестнадесетичната числова & дават &. Имената различават регистъра, а числото означава кодова точка; не всяко число е позволено и невалидните диапазони следват правилата за замяна на анализатора.

В съответстващ източник препратката завършва с точка и запетая. За историческа съвместимост анализаторът възстановява някои имена, така че &copy може да стане ©, но пропускането на точката и запетаята е грешка и може да промени най-дългото съвпадение спрямо ©; не разчитайте на възстановяването.

Стойностите на атрибути имат допълнително историческо изключение: ако съвпадналата именувана препратка няма точка и запетая и следващият знак е ASCII буква или цифра, или знак за равенство, съвпадението не се консумира. Затова &ampx и &amp=1 остават буквални в атрибута, а &amp;=2 декодира амперсанда. Суровото съдържание на <script> и <style> не използва знакови препратки за екраниране.

Примерът декодира в обикновен текст &amp;, &#38;, &#x26;, историческото &copy и пълното &notin;; сравнява и текстовите &ampx и &amp=1 с буквалните стойности на атрибута &ampx и &amp=1. Завършеното &amp;=2 се декодира там, а суровият стил запазва &amp;.

Примери

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

Резултат

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

Изпълненият пример потвърждава именуваните и числовите форми и изключението само за стойности на атрибути, когато след име без точка и запетая има ASCII буква или цифра, или знак за равенство.

Източници