Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

pojęcie HTML: character-references

Odwołania znakowe pozwalają zapisać znak przez nazwę albo punkt kodowy, lecz wynik zależy od poprawnej składni i stanu tokenizera HTML.

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

Składnia

& | & | &

Nazwane & oraz numeryczne dziesiętne & i szesnastkowe & dają znak &. Nazwy rozróżniają wielkość liter, a liczba wskazuje punkt kodowy; nie każda liczba jest dozwolona i niepoprawne zakresy podlegają regułom zamiany parsera.

W zgodnym źródle odwołanie kończy się średnikiem. Parser ze względów historycznych odzyskuje niektóre nazwy, więc &copy może stać się ©, ale brak średnika jest błędem i może zmienić najdłuższe dopasowanie względem ©; nie polegaj na odzyskiwaniu.

Wartość atrybutu ma dodatkowy wyjątek historyczny: gdy dopasowana nazwana referencja nie ma średnika, a następnym znakiem jest znak alfanumeryczny ASCII albo znak równości, dopasowanie nie jest konsumowane. Dlatego &ampx i &amp=1 pozostają dosłowne w atrybucie, natomiast &amp;=2 dekoduje ampersand. Surowa zawartość <script> i <style> nie używa referencji znakowych jako mechanizmu ucieczki.

Przykład dekoduje w zwykłym tekście &amp;, &#38;, &#x26;, historyczne &copy i pełne &notin;; porównuje też tekstowe &ampx i &amp=1 z dosłownymi wartościami &ampx i &amp=1 w atrybucie. Zakończone &amp;=2 dekoduje się tam, a surowy arkusz zachowuje &amp;.

Przykłady

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

Wynik

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

Wykonany przykład potwierdza formy nazwane i numeryczne oraz wyjątek tylko dla wartości atrybutu, gdy po nazwie bez średnika występuje znak alfanumeryczny ASCII albo znak równości.

Źródła