Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

concetto HTML: character-references

I riferimenti a caratteri scrivono un carattere per nome o punto di codice, ma il risultato dipende da sintassi conforme e stato del tokenizer HTML.

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

Sintassi

& | & | &

Il riferimento nominato &, quello numerico decimale & e quello numerico esadecimale & producono tutti &. I nomi distinguono le maiuscole e il numero indica un punto di codice; non ogni numero è ammesso e gli intervalli non validi seguono le regole di sostituzione del parser.

Nel sorgente conforme un riferimento termina con il punto e virgola. Per compatibilità storica il parser recupera alcuni nomi, quindi &copy può diventare ©, ma omettere il punto e virgola è un errore e può cambiare la corrispondenza più lunga rispetto a ©; non affidarti al recupero.

I valori di attributo hanno un’ulteriore eccezione storica: se un riferimento nominato corrispondente non ha il punto e virgola e il carattere seguente è alfanumerico ASCII o un segno uguale, la corrispondenza non viene consumata. Così &ampx e &amp=1 restano letterali nell’attributo, mentre &amp;=2 decodifica la e commerciale. Il contenuto grezzo di <script> e <style> non usa riferimenti come escape.

L’esempio decodifica &amp;, &#38;, &#x26;, lo storico &copy e il completo &notin; nel testo normale; confronta inoltre i testi &ampx e &amp=1 con i valori letterali dell’attributo &ampx e &amp=1. Il &amp;=2 terminato viene decodificato lì, mentre lo stile grezzo conserva &amp;.

Esempi

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

Risultato

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

L’esempio eseguito conferma le forme nominate e numeriche e l’eccezione riservata ai valori di attributo quando un carattere alfanumerico ASCII o un segno uguale segue un nome senza punto e virgola.

Fonti