CKTIS / CSS
@charset — declaración de codificación de una hoja CSS
La secuencia de bytes @charset puede indicar la codificación de una hoja externa, pero solo se reconoce al inicio exacto del flujo y no crea una regla CSSOM.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
@charset "<charset>";@charset "utf-8"; parece una regla arroba, pero CSS Syntax aclara que tal regla no existe. Es una secuencia de bytes reconocida estrictamente al determinar la codificación de una hoja externa. Los bytes deben comenzar exactamente con @charset ", contener una etiqueta entre comillas dobles y terminar con ";. Un comentario o espacio anterior, un espaciado distinto o comillas simples impiden reconocerla como declaración de codificación.
Una etiqueta de codificación de HTTP o protocolo equivalente se considera antes que este patrón. Si no existe, el algoritmo busca la secuencia en los primeros 1024 bytes; un BOM tiene prioridad durante la decodificación real. Las hojas nuevas deben usar UTF-8 declarado por el transporte o el documento referente. Cuando no sea posible, el archivo puede empezar con BOM UTF-8 o con los caracteres exactos @charset "utf-8";. Las etiquetas UTF-16 de esta secuencia compatible con ASCII se resuelven como UTF-8.
El ejemplo construye dos flujos de bytes reales y los carga como hojas externas mediante URL Blob y elementos <link>. El byte 0xB9 representa ą en windows-1250, pero no es válido por sí solo en UTF-8. Con la declaración exacta en el byte cero el resultado contiene ą; al desplazarla con un comentario, el navegador usa UTF-8 y produce el carácter de sustitución. Se prueba la decodificación de bytes, no solo el análisis CSSOM.
Ejemplos
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);Resultado
exact="ą"; displaced="�"
La secuencia de bytes @charset puede indicar la codificación de una hoja externa, pero solo se reconoce al inicio exacto del flujo y no crea una regla CSSOM.