Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

@charset — deklarácia kódovania štýlu CSS

Postupnosť bajtov @charset môže určiť kódovanie externého štýlu, rozpozná sa však iba na úplnom začiatku prúdu a nevytvára pravidlo CSSOM.

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

Syntax

@charset "<charset>";

@charset "utf-8"; vyzerá ako at-pravidlo, CSS Syntax však uvádza, že také pravidlo neexistuje. Ide o presne rozpoznávanú postupnosť bajtov pri určovaní kódovania externého štýlu. Súbor musí začínať presne bajtmi @charset ", obsahovať značku kódovania v dvojitých úvodzovkách a končiť ";. Predchádzajúci komentár či medzera, iné medzery alebo jednoduché úvodzovky zabránia rozpoznaniu deklarácie kódovania.

Značka kódovania z HTTP alebo obdobného protokolu sa použije pred týmto vzorom. Ak chýba, algoritmus hľadá postupnosť v prvých 1024 bajtoch; pri samotnom dekódovaní má BOM prednosť. Nové štýly majú používať UTF-8 deklarované prenosom alebo odkazujúcim dokumentom. Ak to nie je možné, súbor môže začínať BOM UTF-8 alebo presnými znakmi @charset "utf-8";. Značky UTF-16 v tejto postupnosti kompatibilnej s ASCII sa vyhodnotia ako UTF-8.

Príklad vytvorí dva skutočné prúdy bajtov a načíta ich ako externé štýly cez adresy Blob a prvky <link>. Bajt 0xB9 znamená vo windows-1250 znak ą, samostatne však nie je platným bajtom UTF-8. S presnou deklaráciou od nultého bajtu výsledok obsahuje ą; komentár pred ňou ju posunie, prehliadač použije UTF-8 a vznikne náhradný znak. Testuje sa dekódovanie bajtov, nie iba spracovanie CSSOM.

Prí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ýsledok

exact="ą"; displaced="�"

Postupnosť bajtov @charset môže určiť kódovanie externého štýlu, rozpozná sa však iba na úplnom začiatku prúdu a nevytvára pravidlo CSSOM.

Zdroje