CKTIS / CSS
@charset — déclaration d’encodage d’une feuille CSS
La séquence d’octets @charset peut indiquer l’encodage d’une feuille externe, mais seulement au tout début du flux et sans créer de règle CSSOM.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
@charset "<charset>";@charset "utf-8"; ressemble à une règle at, mais CSS Syntax précise qu’une telle règle n’existe pas. C’est une séquence d’octets reconnue de façon stricte lors de la détermination de l’encodage d’une feuille externe. Le fichier doit commencer exactement par @charset ", contenir une étiquette d’encodage entre guillemets doubles et finir par ";. Un commentaire ou un espace placé avant, un espacement différent ou des apostrophes empêchent sa reconnaissance comme déclaration d’encodage.
Une étiquette fournie par HTTP ou un protocole équivalent est examinée avant cette séquence. À défaut, l’algorithme cherche le motif dans les 1024 premiers octets ; un BOM reste prioritaire pendant le décodage. Une nouvelle feuille devrait utiliser UTF-8 déclaré par le transport ou le document référent. Si cela est impossible, le fichier peut commencer par un BOM UTF-8 ou par les caractères exacts @charset "utf-8";. Une étiquette UTF-16 dans cette séquence compatible ASCII conduit à UTF-8.
L’exemple construit deux véritables flux d’octets et les charge comme feuilles externes au moyen d’URL Blob et d’éléments <link>. L’octet 0xB9 représente ą en windows-1250, mais n’est pas valide seul en UTF-8. Avec la déclaration exacte à l’octet zéro, le résultat contient ą ; un commentaire placé avant la décale, le navigateur revient à UTF-8 et produit le caractère de remplacement. Le test porte donc sur le décodage des octets, pas seulement sur CSSOM.
Exemples
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);Résultat
exact="ą"; displaced="�"
La séquence d’octets @charset peut indiquer l’encodage d’une feuille externe, mais seulement au tout début du flux et sans créer de règle CSSOM.