Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła