Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources