CKTIS / CSS
@charset — dichiarazione di codifica di un foglio CSS
La sequenza di byte @charset può indicare la codifica di un foglio esterno, ma viene riconosciuta solo all’inizio esatto del flusso e non crea una regola CSSOM.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
@charset "<charset>";@charset "utf-8"; assomiglia a una regola at, ma CSS Syntax chiarisce che tale regola non esiste. È una sequenza di byte riconosciuta rigidamente quando si determina la codifica di un foglio esterno. Il file deve iniziare esattamente con @charset ", contenere un’etichetta tra virgolette doppie e terminare con ";. Un commento o spazio precedente, una spaziatura diversa o virgolette singole impediscono il riconoscimento come dichiarazione di codifica.
Un’etichetta fornita da HTTP o da un protocollo equivalente viene considerata prima di questo schema. In sua assenza, l’algoritmo cerca la sequenza nei primi 1024 byte; un BOM ha precedenza durante la decodifica effettiva. I nuovi fogli dovrebbero usare UTF-8 dichiarato dal trasporto o dal documento referente. Se ciò non è possibile, il file può iniziare con un BOM UTF-8 o con gli esatti caratteri @charset "utf-8";. Le etichette UTF-16 in questa sequenza compatibile ASCII vengono risolte come UTF-8.
L’esempio costruisce due veri flussi di byte e li carica come fogli esterni tramite URL Blob ed elementi <link>. Il byte 0xB9 rappresenta ą in windows-1250, ma da solo non è valido in UTF-8. Con la dichiarazione esatta al byte zero il risultato contiene ą; se un commento la sposta, il browser usa UTF-8 e produce il carattere sostitutivo. Il test riguarda la decodifica dei byte, non soltanto il parsing CSSOM.
Esempi
const encodedSheet = (leading, className) => {
const head = new TextEncoder().encode(leading + '@charset "windows-1250"; .' + className + '::before { content: "');
const tail = new TextEncoder().encode('"; }');
return new Uint8Array([...head, 0xb9, ...tail]); // 0xB9 is ą in windows-1250, invalid alone in UTF-8
};
const load = async (bytes, className) => {
const url = URL.createObjectURL(new Blob([bytes], {type: 'text/css'}));
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = url;
document.head.append(link);
await new Promise((resolve, reject) => { link.onload = resolve; link.onerror = reject; });
const probe = document.createElement('div');
probe.className = className;
document.body.append(probe);
const content = getComputedStyle(probe, '::before').content;
URL.revokeObjectURL(url);
return content;
};
const exact = await load(encodedSheet('', 'exact'), 'exact');
const displaced = await load(encodedSheet('/*leading*/', 'displaced'), 'displaced');
console.log('exact=' + exact + '; displaced=' + displaced);Risultato
exact="ą"; displaced="�"
La sequenza di byte @charset può indicare la codifica di un foglio esterno, ma viene riconosciuta solo all’inizio esatto del flusso e non crea una regola CSSOM.