Une remarque ? Une suggestion ?...

Merci de participer à l'amélioration de ce site. Prenez le temps de rédiger votre remarque le plus précisément possible :

CSS - Fonction radial-gradient()

Description de la fonction radial-gradient().

La fonction radial-gradient() définit un dégradé de couleurs radial, c'est à dire qui évolue depuis le centre vers les bords de l'élément. Ce dégradé peut être substitué à une image dans toutes les propriétés qui attendent une image mais son utilisation est surtout fréquente avec background-image ou la propriété résumée background.

Pour mémoire, il existe deux autres types de dégradés : les dégradés linéaires et les dégradés coniques, ainsi que leurs variantes avec répétition.

Gradient linéaire avec la fonction linear-gradient()
Gradient linéaire
linear-gradient()
Gradient radial avec la fonction radial-gradient()
Gradient radial
radial-gradient()
Gradient conique avec la fonction conic-gradient()
Gradient conique
conic-gradient()
Gradient linéaire répété avec la fonction repeating-linear-gradient()
Gradient linéaire répété
repeating-linear-gradient()
Gradient radial répété avec la fonction radial-repeating-gradient()
Gradient radial répété
repeating-radial-gradient()
Gradient conique répété avec la fonction conic-repeating-gradient()
Gradient conique répété
repeating-conic-gradient()

Reportez-vous à cette page pour une présentation générale des dégradés.

La fonction radial-gradient() peut être utilisée avec :

Syntaxe de la fonction radial-gradient().

  • background-image: radial-gradient(blue, #90ee90, pink) c1 c2 c3

    Les valeurs c1, c2, etc. sont des couleurs, séparées par des virgules. Elles peuvent être indiquées dans n'importe laquelle des syntaxes reconnues par CSS (code hexadécimal, rgb, hsl, etc. Voir les couleurs CSS.

    Deux couleurs au moins doivent être indiquées. Il n'y a pas de limite sur le nombre maximal de couleurs.

    Le dégradé commence au centre de l'élément et se évolue vers les bords, en gardant le ratio de l'élément. C'est à dire que si l'élément est carré, le dégradé sera circulaire ; si l'élément est rectangulaire, le dégradé sera elliptique, dans les mêmes proportions que l'élément.

  • background-image: radial-gradient(circle, blue, pink) f c1 c2

    Le paramètre supplémentaire f fige la forme du dégradé. Il peut prendre les valeurs suivantes :

    1. circle : le dégradé est circulaire, quelque soit la forme de l'élément sur lequel il est appliqué.
    2. ellipse : le dégradé épouse la forme de l'élément. C'est la valeur par défaut.
  • background-image: radial-gradient(100% 30%, blue, pink) l h c1 c2

    Les paramètres l et h définissent la forme de l'ellipse du dégradé : l est la largeur de l'ellipse, h sa hauteur.

    Si une seule valeur est indiquée, le dégradé est circulaire. Note : dans le cas d'une valeur unique, les pourcentages ne sont pas acceptés.

    Ces deux paramètres sont incompatibles avec le paramètre f vu précédemment.

    Les paramètres l et h sont deux valeurs numériques suivies d'une unité de dimension (voir les unités de dimensions en CSS). Si ce sont des pourcentages, ils sont calculés par rapport à la largeur de l'élément pour l, et par rapport à la hauteur de l'élément pour h.
    l et h peuvent également prendre l'une des valeurs prédéfinies suivantes :

    1. closest-side : distance du bord le plus proche.
    2. farthest-side : distance du bord le plus éloigné.
    3. closest-corner : distance du coin le plus proche.
    4. farthest-corner : distance du coin le plus éloigné.

    Ces valeurs prennent tout leur sens lorsque le dégradé n'est pas centré dans l'élément.

  • background-image: radial-gradient(at 0 25%, blue, pink) x y c1 c2

    Les paramètres x et y introduits par le mot at définissent le point de départ du dégradé. Par défaut on a vu qu'il s'agissait du centre de l'élément.
    Le point 0 0 correspond à l'angle supérieur gauche de l'élément.

    x et y sont deux valeurs numériques suivies d'une unité de dimension (voir les unités de dimensions en CSS). Si ce sont des pourcentages, ils sont calculés par rapport à la largeur de l'élément pour x, et par rapport à la hauteur de l'élément pour y.

    A la place des valeurs numériques il est possible d'indiquer :
    Pour x : right, left, center.
    Pour y : top, bottom, center.

  • background-image: radial-gradient(blue 0%, pink 30%) c1 p1 c2 p2

    Pour chacune des couleurs, il est possible de spécifier une valeur indiquant à quel endroit se font les changements de couleurs. Lorsque ces valeurs ne sont pas spécifiées, les couleurs se répartissent également la place disponible.

    p1, p2, etc. sont des nombres suivis chacun d'une unité de dimension absolue ou relative. Ils doivent être énumérés dans l'ordre croissant.

  • background-image: radial-gradient(40px 100px at 0 0, blue 30%, pink 100%) l h x y c1 p1 c2 p2

    Syntaxe complète, utilisant tous les paramètres.

Exemples.

Cliquez sur les échantillons pour afficher leur code CSS.

Utilisation avec list-style-image
  • Un
  • Deux
  • Trois

Simulateur.

background :
( l h  at x y c1 p1 c2 p2 )

Compatibilité et prise en charge par les navigateurs.

Les dégradés de couleur sont correctement traités par l'ensemble des navigateurs actuels.

Voir aussi...

Arrière-plan - Propriétés.

Arrière-plan - Fonctions.