Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / CSS

@charset — deklaracija kodiranja slogovne pole CSS

Zaporedje bajtov @charset lahko določi kodiranje zunanje slogovne pole, vendar se prepozna le na samem začetku toka in ne ustvari pravila CSSOM.

Različica: 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"; je videti kot pravilo at, vendar CSS Syntax pojasnjuje, da tako pravilo ne obstaja. Gre za strogo prepoznano zaporedje bajtov pri določanju kodiranja zunanje slogovne pole. Datoteka se mora začeti natančno z bajti @charset ", vsebovati oznako kodiranja v dvojnih narekovajih in se zaključiti z ";. Predhodni komentar ali presledek, drugačni presledki ali enojni narekovaji preprečijo prepoznavo deklaracije kodiranja.

Oznaka kodiranja iz HTTP ali enakovrednega protokola se upošteva pred tem vzorcem. Če je ni, algoritem išče zaporedje v prvih 1024 bajtih; pri dejanskem dekodiranju ima BOM prednost. Nove slogovne pole naj uporabljajo UTF-8, ki ga navede prenos ali sklicujoči dokument. Če to ni mogoče, se datoteka lahko začne z BOM UTF-8 ali natančnimi znaki @charset "utf-8";. Oznake UTF-16 v tem z ASCII združljivem zaporedju se obravnavajo kot UTF-8.

Primer zgradi dva dejanska toka bajtov in ju kot zunanji slogovni poli naloži prek naslovov Blob ter elementov <link>. Bajt 0xB9 v windows-1250 pomeni ą, sam pa ni veljaven bajt UTF-8. Z natančno deklaracijo pri bajtu nič rezultat vsebuje ą; ko jo komentar premakne, brskalnik uporabi UTF-8 in ustvari nadomestni znak. Preizkušeno je dekodiranje bajtov, ne le razčlenjevanje CSSOM.

Primeri

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="�"

Zaporedje bajtov @charset lahko določi kodiranje zunanje slogovne pole, vendar se prepozna le na samem začetku toka in ne ustvari pravila CSSOM.

Viri