@charset

La règle @  @charset définit l'encodage des caractères utilisés dans la feuille de style. Cette règle doit être le premier élément de la feuille de style (aucun caractère ne doit être écrit avant). Cette règle ne fait pas partie des instructions imbriquées et ne peut donc pas être utilisée à l'intérieur des groupes conditionnels. Si plusieurs règles @charset sont définies, seule la première sera utilisée. Cette règle ne pourra pas être utilisée au sein d'un attribut style d'un élément HTML ou avec l'élément <style> car c'est l'encodage du document HTML qui est alors pris en compte.

Cette règle @ s'avère notamment utile lorsqu'on utilise des caractères non-ASCII pour certaines propriétés CSS telles que content.

Le moteur dispose de différentes méthodes pour déterminer l'encodage d'une feuille de style. Il utilisera ces ces méthodes dans l'ordre qui suit et s'arrêtera dès qu'un résultat sera obtenu (autrement dit, les règles qui suivent sont triées par priorité décroissante) :

1. La valeur du caractère indiquant l'ordre des octets Unicode qui est placé au début du fichier (le BOM)
2. La valeur fournie par l'attribut charset de l'en-tête HTTP Content-Type ou l'information équivalente dans le protocole utilisé pour servir la feuille de style.
3. La règle @ CSS @charset.
4. L'encodage défini dans le document appelant la ressource (l'attribut charset de l'élément <link>). Cette méthode est désormais obsolète et ne doit plus être utilisée.
5. Dans tous les autres cas, on considère que le document est encodé en UTF-8

Syntaxe

@charset <charset>;

où

charset

Est une chaîne de caractères (une valeur CSS de type  <string>) indiquant l'encodage qui doit être utilisé. Cette valeur doit correspondre à un nom d'encodage valide pour le Web tel que défini dans le registre IANA. Si plusieurs noms sont associés avec l'encodage, seul celui marqué avec préféré  (preferred) doit être utilisé.

Syntaxe formelle

@charset "<charset>";

Exemples

Exemples valides

@charset "UTF-8";      /* Valide, la feuille de style est encodée en Unicode UTF-8 */
@charset 'iso-8859-15'; /* Valide, la feuille de style est encodée en Latin-9 (langues d'Europe occidentale avec le symbole €) */

Exemples invalides

 @charset "UTF-8";      /* Invalide, il y a un caractère (un espace) avant la règle @ */
@charset UTF-8;         /* Invalide, sans ' ou ", le jeu de caractères n'est pas une chaîne CSS (<string>) */

Spécifications

Compatibilité des navigateurs

[1] Firefox 1.0 prenait en charge une syntaxe invalide où l'encodage n'était pas défini entre quotes (simples ou doubles).

[2] Entre IE 5.5 et IE 7 (inclus), Internet Explorer prenait également en charge une syntaxe invalide où l'encodage n'était pas défini entre quotes (simples ou doubles).