--- title: slug: Web/CSS/url tags: - CSS - Reference - Type translation_of: Web/CSS/url ---
{{CSSRef}}

Le type de donnée CSS <url> représente un pointeur vers une ressource (cela peut être une image, une police de caractères). Ce type de données ne possède pas de syntaxe propre et ne peut être utilisé qu'avec la notation fonctionnelle url(). Il est utilisé avec de nombreuses propriétés telles que {{cssxref("background-image")}}, {{cssxref("cursor")}}, {{cssxref("list-style")}}, etc.

Note : URI ou URL ?

Une URI est différente d'une URL. Une URL décrit l'emplacement d'une ressource et l'URI décrit l'identifiant de la ressource. Une URI peut être un emplacement, une URL, un nom, une URN d'une ressource.

Pour la spécification CSS de niveau 1, la notation fonctionnelle url() a été introduite afin de décrire des… URL, autrement dit des emplacements (un type de donnée <url> bien qu'il n'était pas défini explicitement).

Pour la spécification CSS de niveau 2, la même notation fonctionnelle a été étendue afin de pouvoir décrire n'importe quelle URI, que ce soit une URL ou un URN. Cela a été une source d'ambiguïté car  url() était utilisée pour créer une valeur de type <uri>. En plus d'être source de confusion, les URN était très marginalement utilisées dans la pratique.

Afin de remédier à cela, la spécification CSS de niveau 3 est revenue à la définition initiale avec cette fois-ci une définition explicite. La notation fonctionnelle url() représente donc une valeur de type <url> et plus une valeur de type <uri>.

Cela dit, ces détails de sémantique ont peu d'impact pour les auteurs web voire pour l'implémentation du type de donnée par le moteur.

Syntaxe

L'URL peut être indiquée telle quelle comme argument de la fonction url()et encadrée, ou non, entre quotes ou doubles quotes. Il est possible d'utiliser des URL relatives. Celles-ci sont alors relatives à l'URL de la feuille de style (et non à l'URL de la page web).

 <propriété_css>:  url("http://monsite.exemple.com/curseur.png")
 <propriété_css>: url("http://monsite.exemple.com/curseur.png")
 <propriété_css>:  url(http://monsite.exemple.com/curseur.png)

Note : Les caractères de contrôle au-delà de 0x7e ne sont plus autorisés pour la forme sans quote à partir de Firefox 15. Voir {{bug(752230)}} pour plus d'informations.

Exemples

CSS

ul {
  list-style-image: url("https://mdn.mozillademos.org/files/11981/starsolid.gif")
}

HTML

<ul>
    <li>Élément 1</li>
    <li>Élément 2</li>
</ul>

Résultat

{{EmbedLiveSample('Exemples')}}

Spécifications

Spécification État Commentaires
{{SpecName('CSS4 Values', '#urls', '<url>')}} {{Spec2('CSS4 Values')}}
{{SpecName('CSS3 Values', '#urls', '<url>')}} {{Spec2('CSS3 Values')}} Aucune modification significative.
{{Specname('CSS2.1', 'syndata.html#uri', '<uri>')}} {{Spec2('CSS2.1')}} Aucune modification significative.
{{SpecName('CSS1', '#url', '<url>')}} {{Spec2('CSS1')}} Définition initiale.

Compatibilité des navigateurs

{{Compat("css.types.url")}}

Voir aussi