База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

@charset — декларация за кодиране на CSS таблица

Последователността от байтове @charset може да укаже кодирането на външна таблица, но се разпознава само в самото начало и не създава CSSOM правило.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

@charset "<charset>";

@charset "utf-8"; прилича на at-правило, но CSS Syntax уточнява, че такова правило не съществува. Това е строго разпознавана последователност от байтове при определяне на кодирането на външна таблица със стилове. Файлът трябва да започва точно с байтовете @charset ", да съдържа етикет за кодиране в двойни кавички и да завършва с ";. Предшестващ коментар или интервал, различни интервали или единични кавички пречат на разпознаването.

Етикет от HTTP или равностоен протокол се разглежда преди този шаблон. Ако липсва, алгоритъмът търси последователността в първите 1024 байта; при действителното декодиране BOM има предимство. Новите таблици трябва да използват UTF-8, декларирано от транспорта или препращащия документ. Ако това не е възможно, файлът може да започва с UTF-8 BOM или с точните знаци @charset "utf-8";. Етикетите UTF-16 в тази съвместима с ASCII последователност се третират като UTF-8.

Примерът изгражда два реални потока от байтове и ги зарежда като външни таблици чрез Blob адреси и елементи <link>. Байтът 0xB9 означава ą в windows-1250, но самостоятелно не е валиден UTF-8 байт. При точна декларация от нулевия байт резултатът съдържа ą; когато коментар я измести, браузърът използва UTF-8 и получава заместващ знак. Тества се декодирането на байтове, а не само CSSOM анализът.

Примери

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

Резултат

exact="ą"; displaced="�"

Последователността от байтове @charset може да укаже кодирането на външна таблица, но се разпознава само в самото начало и не създава CSSOM правило.

Източници