<gradient>

Exemple interactif

background: linear-gradient(#f69d3c, #3f87a6);

background: radial-gradient(#f69d3c, #3f87a6);

background: repeating-linear-gradient(#f69d3c, #3f87a6 50px);

background: repeating-radial-gradient(#f69d3c, #3f87a6 50px);

background: conic-gradient(#f69d3c, #3f87a6);

<section class="display-block" id="default-example">
  <div id="example-element"></div>
</section>

#example-element {
  min-height: 100%;
}

Un dégradé CSS est sans dimension intrinsèque : il n'a ni taille naturelle ni préférée, ni ratio préféré. Sa taille réelle correspond à celle de l'élément auquel il s'applique.

Syntaxe

Le type de donnée <gradient> se définit à l'aide de l'une des fonctions suivantes.

Dégradé linéaire

Les dégradés linéaires font évoluer les couleurs le long d'une ligne imaginaire. Ils sont générés avec la fonction linear-gradient().

Dégradé radial

Les dégradés radiaux font évoluer les couleurs à partir d'un point central (origine). Ils sont générés avec la fonction radial-gradient().

Dégradé conique

Les dégradés coniques font évoluer les couleurs autour d'un cercle. Ils sont générés avec la fonction conic-gradient().

Dégradé répétitif

Les dégradés répétitifs dupliquent un dégradé autant que nécessaire pour remplir la zone. Ils sont générés avec les fonctions repeating-linear-gradient(), repeating-radial-gradient() et repeating-conic-gradient().

Interpolation

Comme pour toute interpolation de couleurs, les dégradés sont calculés dans l'espace colorimétrique alpha-prémultiplié. Cela évite l'apparition de teintes grises inattendues lorsque la couleur et l'opacité varient. (Attention : les anciens navigateurs peuvent ne pas utiliser ce comportement avec le mot-clé transparent.)

Syntaxe formelle

<gradient> = 
  <linear-gradient()>            |
  <repeating-linear-gradient()>  |
  <radial-gradient()>            |
  <repeating-radial-gradient()>  

<linear-gradient()> = 
  linear-gradient( [ <linear-gradient-syntax> ] )  

<repeating-linear-gradient()> = 
  repeating-linear-gradient( [ <linear-gradient-syntax> ] )  

<radial-gradient()> = 
  radial-gradient( [ <radial-gradient-syntax> ] )  

<repeating-radial-gradient()> = 
  repeating-radial-gradient( [ <radial-gradient-syntax> ] )  

<linear-gradient-syntax> = 
  [ <angle> | <zero> | to <side-or-corner> ]? , <color-stop-list>  

<radial-gradient-syntax> = 
  [ <radial-shape> || <radial-size> ]? [ at <position> ]? , <color-stop-list>  

<side-or-corner> = 
  [ left | right ]  ||
  [ top | bottom ]  

<color-stop-list> = 
  <linear-color-stop> , [ <linear-color-hint>? , <linear-color-stop> ]#?  

<radial-shape> = 
  circle   |
  ellipse  

<radial-size> = 
  <radial-extent>               |
  <length [0,∞]>                |
  <length-percentage [0,∞]>{2}  

<position> = 
  [ left | center | right | top | bottom | <length-percentage> ]  |
  [ left | center | right ] && [ top | center | bottom ]  |
  [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ]  |
  [ [ left | right ] <length-percentage> ] && [ [ top | bottom ] <length-percentage> ]  

<linear-color-stop> = 
  <color> <length-percentage>?  

<linear-color-hint> = 
  <length-percentage>  

<radial-extent> = 
  closest-corner   |
  closest-side     |
  farthest-corner  |
  farthest-side    

<length-percentage> = 
  <length>      |
  <percentage>  

Exemples

Exemple de dégradé linéaire

Un dégradé linéaire.

<div class="linear-gradient">Dégradé linéaire</div>

div {
  width: 240px;
  height: 80px;
}

.linear-gradient {
  background: linear-gradient(
    to right,
    red,
    orange,
    yellow,
    green,
    blue,
    indigo,
    violet
  );
}

Exemple de dégradé radial

Un dégradé radial.

<div class="radial-gradient">Dégradé radial</div>

div {
  width: 240px;
  height: 80px;
}

.radial-gradient {
  background: radial-gradient(red, yellow, dodgerblue);
}

Exemple de dégradé conique

Un exemple de dégradé conique.

<div class="conic-gradient">Dégradé conique</div>

div {
  width: 200px;
  height: 200px;
}

.conic-gradient {
  background: conic-gradient(pink, coral, lime);
}

Exemples de dégradés répétitifs

Exemples de dégradés linéaire, radial et conique répétitifs.

<div class="linear-repeat"></div>
<span>Dégradé linéaire répétitif</span>
<hr />
<div class="radial-repeat"></div>
<span>Dégradé radial répétitif</span>
<hr />
<div class="conic-repeat"></div>
<span>Dégradé conique répétitif</span>

div {
  display: inline-block;
  width: 240px;
  height: 80px;
}

span {
  font-weight: bold;
  vertical-align: top;
}

.linear-repeat {
  background: repeating-linear-gradient(
    to top left,
    pink,
    pink 5px,
    white 5px,
    white 10px
  );
}

.radial-repeat {
  background: repeating-radial-gradient(
    lime,
    lime 15px,
    white 15px,
    white 30px
  );
}

.conic-repeat {
  background: repeating-conic-gradient(lime, pink 30deg);
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• Manipuler les dégradés CSS
• Fonctions de dégradé : linear-gradient(), repeating-linear-gradient(), radial-gradient(), repeating-radial-gradient(), conic-gradient(), repeating-conic-gradient()
• Les types de donnée en CSS
• Les unités et valeurs en CSS
• Introduction à CSS : les unités et les valeurs