Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti