@charset
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
@charset "utf-8";
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 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) :
- La valeur du caractère indiquant l'ordre des octets Unicode qui est placé au début du fichier (le BOM)
- La valeur fournie par l'attribut
charset
de l'en-tête HTTPContent-Type
ou l'information équivalente dans le protocole utilisé pour servir la feuille de style. - La règle @ CSS
@charset
. - 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. - 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 et doit être délimitée par des doubles quotes, précédée d'un blanc (U+0020) et suivie d'un point-virgule. Si plusieurs noms sont associés avec l'encodage, seul celui marqué avec préféré (preferred) doit être utilisé.
Syntaxe formelle
Error: could not find syntax for this item
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
Specification |
---|
Cascading Style Sheets Level 2 Revision 2 (CSS 2.2) Specification # charset① |
Compatibilité des navigateurs
BCD tables only load in the browser