CKTIS / CSS
@charset — deklaracja kodowania arkusza CSS
Sekwencja @charset może wskazać kodowanie bajtów zewnętrznego arkusza, ale jest rozpoznawana tylko na samym początku strumienia i nie tworzy reguły CSSOM.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
@charset "<charset>";Zapis @charset "utf-8"; wygląda jak reguła at-rule, lecz CSS Syntax wyjaśnia, że taka reguła nie istnieje. Jest to ściśle rozpoznawana sekwencja bajtów używana przy ustalaniu kodowania zewnętrznego arkusza. Musi zaczynać pierwsze bajty pliku dokładnie od @charset ", mieć etykietę kodowania w cudzysłowie podwójnym i kończyć się ";. Poprzedzający komentarz, odstęp, inna liczba spacji lub cudzysłów pojedynczy uniemożliwia rozpoznanie deklaracji kodowania.
Najpierw pierwszeństwo ma etykieta kodowania z HTTP lub równoważnego protokołu. Bez niej algorytm sprawdza tę sekwencję w pierwszych 1024 bajtach; BOM ma pierwszeństwo podczas właściwego dekodowania. Dla nowych arkuszy praktycznym wyborem jest UTF-8 zadeklarowane w nagłówku albo przez dokument odsyłający. Gdy tych mechanizmów nie można użyć, plik może zaczynać BOM UTF-8 albo dokładne @charset "utf-8";. Etykiety UTF-16 w tej sekwencji są traktowane jako UTF-8, ponieważ sama deklaracja jest zapisana bajtami zgodnymi z ASCII.
Przykład buduje dwa rzeczywiste strumienie bajtów i ładuje je jako zewnętrzne arkusze przez adresy Blob oraz elementy <link>. Bajt 0xB9 oznacza ą w windows-1250, ale sam nie jest poprawnym znakiem UTF-8. Gdy dokładna deklaracja zaczyna plik, wynik zawiera ą; po przesunięciu jej komentarzem przeglądarka używa domyślnego UTF-8 i otrzymuje znak zastępczy. To test etapu dekodowania, nie samego parsera CSSOM.
Przykłady
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);Wynik
exact="ą"; displaced="�"
Sekwencja @charset może wskazać kodowanie bajtów zewnętrznego arkusza, ale jest rozpoznawana tylko na samym początku strumienia i nie tworzy reguły CSSOM.