Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

@charset — deklarace kódování stylu CSS

Posloupnost bajtů @charset může určit kódování externího stylu, rozpozná se však pouze na úplném začátku proudu a nevytváří pravidlo CSSOM.

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

Syntaxe

@charset "<charset>";

@charset "utf-8"; vypadá jako at-pravidlo, CSS Syntax však uvádí, že takové pravidlo neexistuje. Jde o přesně rozpoznávanou posloupnost bajtů při určování kódování externího stylu. Soubor musí začínat přesně bajty @charset ", obsahovat značku kódování v dvojitých uvozovkách a končit ";. Předchozí komentář či mezera, jiné mezery nebo jednoduché uvozovky zabrání rozpoznání deklarace kódování.

Značka kódování z HTTP nebo obdobného protokolu se použije před tímto vzorem. Pokud chybí, algoritmus hledá posloupnost v prvních 1024 bajtech; při vlastním dekódování má BOM přednost. Nové styly mají používat UTF-8 deklarované přenosem nebo odkazujícím dokumentem. Není-li to možné, může soubor začít BOM UTF-8 nebo přesnými znaky @charset "utf-8";. Značky UTF-16 v této posloupnosti kompatibilní s ASCII se vyhodnotí jako UTF-8.

Příklad vytvoří dva skutečné proudy bajtů a načte je jako externí styly přes adresy Blob a prvky <link>. Bajt 0xB9 znamená v windows-1250 znak ą, samostatně však není platným bajtem UTF-8. S přesnou deklarací od nultého bajtu výsledek obsahuje ą; komentář před ní ji posune, prohlížeč použije UTF-8 a vznikne náhradní znak. Testuje se dekódování bajtů, nikoli jen zpracování CSSOM.

Příklady

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

Výsledek

exact="ą"; displaced="�"

Posloupnost bajtů @charset může určit kódování externího stylu, rozpozná se však pouze na úplném začátku proudu a nevytváří pravidlo CSSOM.

Zdroje