Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / CSS

@charset — deklaracija kodiranja CSS lista

Slijed bajtova @charset može odrediti kodiranje vanjskog lista stilova, ali prepoznaje se samo na samom početku toka i ne stvara CSSOM pravilo.

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

Sintaksa

@charset "<charset>";

@charset "utf-8"; izgleda kao at-pravilo, ali CSS Syntax objašnjava da takvo pravilo ne postoji. To je strogo prepoznat slijed bajtova pri određivanju kodiranja vanjskog lista stilova. Datoteka mora početi točno bajtovima @charset ", sadržavati oznaku kodiranja u dvostrukim navodnicima i završiti s ";. Prethodni komentar ili razmak, drukčiji razmaci ili jednostruki navodnici sprečavaju prepoznavanje deklaracije kodiranja.

Oznaka kodiranja iz HTTP-a ili jednakovrijednog protokola razmatra se prije ovog uzorka. Ako je nema, algoritam traži slijed u prvih 1024 bajta; pri stvarnom dekodiranju BOM ima prednost. Novi listovi trebaju rabiti UTF-8 koji je deklariran prijenosom ili dokumentom koji upućuje na njih. Ako to nije moguće, datoteka može početi BOM-om UTF-8 ili točnim znakovima @charset "utf-8";. Oznake UTF-16 u ovom slijedu usklađenom s ASCII-jem obrađuju se kao UTF-8.

Primjer gradi dva stvarna toka bajtova i učitava ih kao vanjske listove putem Blob URL-ova i elemenata <link>. Bajt 0xB9 u windows-1250 predstavlja ą, ali sam nije valjan UTF-8 bajt. S točnom deklaracijom na nultom bajtu rezultat sadrži ą; kad je komentar pomakne, preglednik rabi UTF-8 i daje zamjenski znak. Ispituje se dekodiranje bajtova, a ne samo CSSOM parser.

Primjeri

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

Rezultat

exact="ą"; displaced="�"

Slijed bajtova @charset može odrediti kodiranje vanjskog lista stilova, ali prepoznaje se samo na samom početku toka i ne stvara CSSOM pravilo.

Izvori