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.