@import
Inclut le contenu d’une autre feuille de style CSS dans la feuille courante. Elle peut la placer directement dans une couche ou ne la charger que pour certains médias.
Exemple
#@import url("reset.css") layer(reset);
@import url("theme.css") layer(theme);
@import url("print.css") print;
.button {
background: #7c3aed;
}Les imports se trouvent tout en haut du fichier. Les styles de reset.css et theme.css vont dans des couches, si bien que les règles ordinaires, comme .button, l’emportent toujours sur eux. Le fichier print.css ne s’applique qu’à l’impression. L’exemple n’a pas d’aperçu, car le cadre ne contient pas ces fichiers.
Définition et utilisation
#La règle @import charge un autre fichier CSS et traite ses règles comme si elles se trouvaient à l’endroit de l’import. Vous indiquez l’adresse sous la forme url("fichier.css") ou simplement un texte entre guillemets. Les chemins relatifs se calculent à partir de l’emplacement de la feuille de style qui contient l’import, et non de la page HTML.
L’import doit se trouver tout en haut de la feuille de style, avant toutes les autres règles. Seuls @charset et les déclarations d’ordre des couches sous la forme @layer a, b; peuvent le précéder. Un import placé plus bas est ignoré silencieusement par le navigateur.
Après l’adresse, vous pouvez ajouter des conditions. layer(nom) place tout le fichier dans une couche de cascade, ce qui convient parfaitement aux resets et aux bibliothèques : leurs styles perdent face aux vôtres, même s’ils ont une spécificité plus élevée. Une requête de média, par ex. print ou (width >= 900px), fait que les règles du fichier ne s’appliquent que lorsque la condition est remplie.
Faites attention aux performances. Le navigateur ne découvre un import qu’après avoir téléchargé et lu la feuille de style qui le contient, si bien que les fichiers se chargent l’un après l’autre au lieu d’en parallèle. En production, il vaut mieux inclure les feuilles de style avec des balises <link> distinctes dans le HTML ou les fusionner en un seul fichier avec un outil de build, par ex. Vite, qui résout les imports dès la construction.
Syntaxe
#@import url("fichier.css");
@import "fichier.css";
@import url("fichier.css") layer(<nom>);
@import url("fichier.css") <requête de média>;Plus d’exemples
#@layer reset, vendor, app;
@import url("reset.css") layer(reset);
@import url("vendor/slider.css") layer(vendor);
@layer app {
.slider {
border-radius: 12px;
}
}Une déclaration @layer peut précéder les imports et fixe l’ordre des couches. Un style de la couche app l’emportera sur la bibliothèque, même si ses sélecteurs étaient plus spécifiques.
<link rel="stylesheet" href="/css/reset.css">
<link rel="stylesheet" href="/css/theme.css">
<link rel="stylesheet" href="/css/print.css" media="print">Le navigateur voit toutes les feuilles de style d’un coup et les télécharge en parallèle. Une feuille de style avec media="print" ne bloque pas l’affichage de la page à l’écran.
Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Placez les imports tout au début du fichier. Un import situé après une règle ordinaire ne fonctionnera pas, et le navigateur ne signale aucune erreur.
- Importez les bibliothèques externes avec
layer(). Vous n’aurez pas besoin d’augmenter la spécificité ni d’utiliser!importantpour écraser leurs styles. - Évitez les chaînes d’imports où un fichier en importe un autre, qui en importe un troisième. Chaque maillon est une attente réseau supplémentaire.
Entrées associées
#- @layerRépartit les styles en couches de cascade d’ordre fixe. Une règle d’une couche ultérieure l’emporte quelle que soit la spécificité du sélecteur.
- @mediaN’active des styles que lorsque l’appareil remplit une condition : largeur de fenêtre adaptée, thème sombre, souris ou impression de la page.
- @font-faceEnregistre une police sous un nom choisi, que vous utilisez ensuite dans font-family. Elle permet d’employer des polices issues des fichiers de votre propre site.
- SpécificitéLe poids d’un sélecteur, qui détermine quelle règle gagne lorsque plusieurs règles définissent la même propriété du même élément.
- @supportsN’active des styles que dans les navigateurs qui gèrent une propriété, une valeur ou un sélecteur donné, pour utiliser les nouveautés sans risque.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.