CKTIS / CSS
@charset — Kodierungsdeklaration eines CSS-Stylesheets
Die Bytefolge @charset kann die Kodierung eines externen Stylesheets angeben, wird aber nur ganz am Streamanfang erkannt und erzeugt keine CSSOM-Regel.
Version: 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"; sieht wie eine At-Regel aus, doch laut CSS Syntax existiert eine solche Regel nicht. Es handelt sich um eine streng erkannte Bytefolge zur Ermittlung der Kodierung eines externen Stylesheets. Die Datei muss bytegenau mit @charset " beginnen, ein Kodierungslabel in doppelten Anführungszeichen enthalten und mit "; enden. Ein vorangestellter Kommentar oder Leerraum, zusätzliche Abstände oder einfache Anführungszeichen verhindern die Erkennung als Kodierungsdeklaration.
Ein Kodierungslabel aus HTTP oder einem gleichwertigen Protokoll wird vor diesem Bytemuster berücksichtigt. Fehlt es, prüft der Algorithmus das Muster in den ersten 1024 Bytes; beim eigentlichen Dekodieren hat eine BOM Vorrang. Neue Stylesheets sollten UTF-8 verwenden, das über den Transport oder das verweisende Dokument deklariert ist. Wenn beides nicht möglich ist, kann die Datei mit einer UTF-8-BOM oder den exakten Zeichen @charset "utf-8"; beginnen. UTF-16-Labels in dieser ASCII-kompatiblen Folge werden als UTF-8 behandelt.
Das Beispiel erzeugt zwei echte Byteströme und lädt sie über Blob-URLs und <link>-Elemente als externe Stylesheets. Das Byte 0xB9 steht in windows-1250 für ą, ist allein aber kein gültiges UTF-8-Zeichen. Beginnt die exakte Deklaration bei Byte null, enthält das Ergebnis ą; wird sie durch einen Kommentar verschoben, verwendet der Browser UTF-8 und erzeugt das Ersatzzeichen. Getestet wird die Byte-Dekodierung, nicht nur das CSSOM-Parsing.
Beispiele
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);Ergebnis
exact="ą"; displaced="�"
Die Bytefolge @charset kann die Kodierung eines externen Stylesheets angeben, wird aber nur ganz am Streamanfang erkannt und erzeugt keine CSSOM-Regel.