KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

@charset — coderingsdeclaratie van een CSS-stijlblad

De bytevolgorde @charset kan de codering van een extern stijlblad aangeven, maar wordt alleen helemaal aan het streambegin herkend en vormt geen CSSOM-regel.

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

Syntax

@charset "<charset>";

@charset "utf-8"; lijkt op een at-regel, maar CSS Syntax legt uit dat zo’n regel niet bestaat. Het is een strikt herkende bytevolgorde voor het bepalen van de codering van een extern stijlblad. Het bestand moet byte voor byte beginnen met @charset ", een coderingslabel tussen dubbele aanhalingstekens bevatten en eindigen met ";. Een voorafgaand commentaar of spatie, andere spatiëring of enkele aanhalingstekens verhindert herkenning als coderingsdeclaratie.

Een coderingslabel uit HTTP of een gelijkwaardig protocol wordt vóór dit patroon gebruikt. Ontbreekt dat, dan controleert het algoritme de eerste 1024 bytes; tijdens het echte decoderen heeft een BOM voorrang. Nieuwe stijlbladen horen UTF-8 te gebruiken dat door transport of verwijzend document is gedeclareerd. Kan dat niet, dan mag het bestand met een UTF-8-BOM of de exacte tekens @charset "utf-8"; beginnen. UTF-16-labels in deze ASCII-compatibele reeks worden als UTF-8 behandeld.

Het voorbeeld bouwt twee echte bytestromen en laadt die via Blob-URL’s en <link>-elementen als externe stijlbladen. Byte 0xB9 is in windows-1250 de letter ą, maar is los geen geldige UTF-8-byte. Met de exacte declaratie op byte nul bevat het resultaat ą; na verschuiving door een commentaar gebruikt de browser UTF-8 en ontstaat het vervangingsteken. Dit test de bytendecodering en niet alleen CSSOM-parsing.

Voorbeelden

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

Resultaat

exact="ą"; displaced="�"

De bytevolgorde @charset kan de codering van een extern stijlblad aangeven, maar wordt alleen helemaal aan het streambegin herkend en vormt geen CSSOM-regel.

Bronnen