radial-gradient() - Fonction CSS
Résumé des caractéristiques de la 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 radial
radial-gradient()
Reportez-vous à la page linear-gradient()
pour une présentation plus complète des dégradés.
La fonction radial-gradient() peut être utilisée avec :
background-image
: Image d'arrière-plan.border-image
: Résumé des propriétés des bordures réalisées avec des images.list-style-image
: Définit une image à utiliser à la place des puces.mask-image
: Désigne l'image ou le fichier SVG qui sera utilisé comme masque.
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 :circle
: le dégradé est circulaire, quelque soit la forme de l'élément sur lequel il est appliqué.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
eth
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
eth
sont deux valeurs numériques suivies d'une unité de dimension (voir les unités CSS de dimension). Si ce sont des pourcentages, ils sont calculés par rapport à la largeur de l'élément pourl
, et par rapport à la hauteur de l'élément pourh
.
l
eth
peuvent également prendre l'une des valeurs prédéfinies suivantes :closest-side
: distance du bord le plus proche.farthest-side
: distance du bord le plus éloigné.closest-corner
: distance du coin le plus proche.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
ety
introduits par le motat
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 point0 0
correspond à l'angle supérieur gauche de l'élément.x
ety
sont deux valeurs numériques suivies d'une unité de dimension (voir les unités CSS de dimension). Si ce sont des pourcentages, ils sont calculés par rapport à la largeur de l'élément pourx
, et par rapport à la hauteur de l'élément poury
.A la place des valeurs numériques il est possible d'indiquer :
Pourx
:right
,left
,center
.
Poury
: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.
list-style-image
- Un
- Deux
- Trois
Simulateur.
Prise en charge par les navigateurs (compatibilité).
Les dégradés de couleur sont correctement traités par l'ensemble des navigateurs actuels.
radial-gradient()
.
radial-gradient()
Navigateurs sur ordinateurs :
Navigateurs sur mobiles :
Navigateurs obsolètes ou marginaux :
Androïd Brower
Baidu Browser
Chrome
Chrome pour Androïd
Edge
Firefox
Firefox pour Androïd
Internet Explorer
KaiOS Browser
Opéra
Opéra Mobile
QQ Browser
Safari
Safari sur IOS
Samsung Internet
Oméra mini
Voir aussi, dans le même module de standardisation que radial-gradient()
.
Les spécifications CSS éditées par le W3C sont organisées en modules. radial-gradient()
fait partie du Module CSS - Images (CSS Images Module). Les définitions suivantes sont également décrites dans ce même module.