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

CKTIS / CSS

url() : une référence de ressource, pas une garantie de chargement

Écrivez les chemins entre guillemets, comprenez leur URL de base et séparez l’analyse du chargement d’une ressource utilisable.

Version : CSS Modules

Syntaxe

background-image: url("images/pattern.svg");

url() fournit une référence de ressource dans des contextes comme background-image, une source de police ou une référence à un filtre SVG. Une chaîne entre guillemets est pratique quand le chemin contient des espaces ou des parenthèses. La forme sans guillemets impose des règles d’échappement plus strictes ; un espace interne non échappé n’est pas accepté dans son jeton URL. Une simple chaîne à la place de la fonction n’est autorisée que dans les contextes qui le prévoient explicitement, comme @import.

Les références relatives d’une feuille de style externe se basent sur l’emplacement de cette feuille. Le CSS intégré au document et les styles en ligne utilisent la base du document contenant. Déplacer une feuille dans un autre répertoire peut donc casser ses chemins d’images relatifs sans changer l’adresse HTML. Une référence composée uniquement d’un fragment, comme url("#filter"), suit des règles locales pour les éléments de l’arbre concerné ; ce n’est pas simplement un chemin de fichier relatif ordinaire.

La syntaxe acceptée est distincte de la disponibilité de la ressource, des politiques autorisant les requêtes et d’un format utilisable dans la propriété choisie. Un url("") vide constitue une ressource invalide, pas une instruction de charger la page actuelle. url(var(--path)) échoue aussi à cause de l’analyse particulière des jetons URL ; une solution courante consiste à stocker la valeur complète url("...") dans une propriété personnalisée et à utiliser var() comme valeur de la propriété.

L’exemple définit une base de document sous /pages/ et mesure une référence relative en ligne résolue vers /pages/tiles/pattern.svg. L’adresse absolue contenant /assets/pattern.svg reste absolue. Le contrôle de l’espace entre guillemets renvoie true, celui sans guillemets false, et la référence vide est sérialisée en url(""). Les requêtes externes sont bloquées dans le test enregistré : il vérifie la syntaxe et la résolution calculée des URL, pas des téléchargements réussis ni des images affichées.

Exemples

const base=document.createElement('base');base.href='https://example.invalid/pages/';document.head.append(base);
const inline=document.createElement('div');inline.style.backgroundImage='url("tiles/pattern.svg")';document.body.append(inline);
const inlineResolved=getComputedStyle(inline).backgroundImage;
const absolute=document.createElement('div');absolute.style.backgroundImage='url("https://example.invalid/assets/pattern.svg")';document.body.append(absolute);
const absoluteResolved=getComputedStyle(absolute).backgroundImage;
inline.style.backgroundImage='url("")';const empty=getComputedStyle(inline).backgroundImage;
console.log('inline='+inlineResolved+'; absolute='+absoluteResolved+'; quoted-space='+CSS.supports('background-image','url("a b.svg")')+'; unquoted-space='+CSS.supports('background-image','url(a b.svg)')+'; empty='+empty);

Résultat

inline=url("https://example.invalid/pages/tiles/pattern.svg"); absolute=url("https://example.invalid/assets/pattern.svg"); quoted-space=true; unquoted-space=false; empty=url("")

L’hôte réservé example.invalid indique clairement le caractère illustratif des adresses. L’exemple utilise des styles en ligne ; la règle distincte des bases de feuilles externes est expliquée dans le texte, sans être présentée comme un test réseau exécuté.

Sources