CKTIS / CSS
@import — charger une autre feuille de style
La règle @import charge une feuille CSS par URL et peut la conditionner par une couche, une requête de prise en charge ou une requête média.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
@import [ <string> | <url> ]
[ layer | layer(<layer-name>) ]?
[ supports( [ <supports-condition> | <declaration> ] ) ]?
<media-query-list>? ;@import <url-or-string> [layer | layer(<name>)]? [supports(<condition>)]? <media-query-list>?; est une instruction terminée par un point-virgule. Les règles importées se comportent comme si elles figuraient à cet emplacement. layer les place dans une couche, supports() peut éviter le chargement si la condition est fausse et une liste média limite leur application.
@import doit précéder les règles de style ordinaires et la plupart des autres règles ; une déclaration d’encodage et certains ordres de couches peuvent venir avant. Un import dans un bloc ou après une règle interdite est ignoré. Une URL relative est résolue par rapport à la feuille importatrice, pas directement au document HTML.
Chaque import peut allonger la chaîne de chargement ; <link> ou un bundle sont souvent préférables. Un échec n’élimine pas le reste de la feuille. L’exemple charge une feuille Blob qui importe une feuille data:, puis lit après load une valeur importée et une valeur locale.
Exemples
const css = '@import url("data:text/css,.probe%7B--from-import%3Aloaded%7D"); .probe { --local: ready; }';
const url = URL.createObjectURL(new Blob([css], {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 = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
console.log('import=' + computed.getPropertyValue('--from-import').trim() + '; local=' + computed.getPropertyValue('--local').trim());
URL.revokeObjectURL(url);Résultat
import=loaded; local=ready
La règle @import charge une feuille CSS par URL et peut la conditionner par une couche, une requête de prise en charge ou une requête média.