Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@charset — declaração de codificação de uma folha CSS

A sequência de bytes @charset pode indicar a codificação de uma folha externa, mas só é reconhecida no início exato do fluxo e não cria uma regra CSSOM.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

@charset "<charset>";

@charset "utf-8"; parece uma regra at, mas CSS Syntax esclarece que essa regra não existe. É uma sequência de bytes reconhecida de forma estrita ao determinar a codificação de uma folha externa. O ficheiro tem de começar exatamente por @charset ", conter uma etiqueta entre aspas duplas e terminar em ";. Um comentário ou espaço anterior, espaçamento diferente ou aspas simples impede o reconhecimento como declaração de codificação.

Uma etiqueta fornecida por HTTP ou protocolo equivalente é considerada antes deste padrão. Na sua ausência, o algoritmo procura a sequência nos primeiros 1024 bytes; um BOM tem prioridade durante a descodificação efetiva. Folhas novas devem usar UTF-8 declarado pelo transporte ou documento referenciador. Se isso não for possível, o ficheiro pode começar por um BOM UTF-8 ou pelos carateres exatos @charset "utf-8";. Etiquetas UTF-16 nesta sequência compatível com ASCII resultam em UTF-8.

O exemplo constrói dois fluxos de bytes reais e carrega-os como folhas externas através de URLs Blob e elementos <link>. O byte 0xB9 representa ą em windows-1250, mas isolado não é válido em UTF-8. Com a declaração exata no byte zero o resultado contém ą; quando um comentário a desloca, o navegador usa UTF-8 e produz o caráter de substituição. O teste exercita a descodificação de bytes, não apenas o processamento do CSSOM.

Exemplos

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);

Resultado

exact="ą"; displaced="�"

A sequência de bytes @charset pode indicar a codificação de uma folha externa, mas só é reconhecida no início exato do fluxo e não cria uma regra CSSOM.

Fontes