linear-gradient()

Crée une transition de couleurs le long d’une ligne droite. Elle s’utilise comme une image, le plus souvent dans background ou background-image.

Sur cette page

Exemple

#
CSS
.hero {
  background:
    linear-gradient(to top, rgb(12 12 16 / 0.95), transparent 70%),
    url("/collections/covers/kurs-html-css-od-podstaw.webp") center / cover;
}
Aperçu

Le dégradé assombrit le bas de la photo, ce qui rend le texte blanc lisible quel que soit le contenu de l’image.

Définition et utilisation

#

La fonction linear-gradient() génère une image dans laquelle les couleurs se fondent en douceur les unes dans les autres le long d’une ligne droite. Comme c’est une image et non une couleur, vous la placez là où CSS accepte des images : dans background-image ou la propriété raccourcie background, mais aussi dans border-image et mask-image. Elle ne fonctionne pas dans background-color ni dans color.

Le premier argument, facultatif, est la direction. Les mots to right ou to bottom right indiquent le bord ou le coin vers lequel va le dégradé, et un angle, par exemple 45deg, fait pivoter la ligne : 0deg pointe vers le haut, 90deg vers la droite, et la valeur par défaut 180deg, soit to bottom, vers le bas.

Après la direction, vous énumérez les couleurs, au moins deux. Chacune peut avoir une position : #7c3aed 20% signifie que le violet pur commence à 20 % de la longueur du dégradé. Deux couleurs à la même position donnent une limite nette au lieu d’une transition, ce qui permet de dessiner des rayures. La version repeating-linear-gradient() répète le motif indéfiniment.

Dans background, vous pouvez donner plusieurs couches séparées par des virgules, par exemple un dégradé semi-transparent sur une photo pour que le texte qui s’y trouve reste lisible. Pour obtenir un changement fluide d’un dégradé, le plus sûr est d’animer sa position (background-position) ou une variable enregistrée avec @property.

Syntaxe

#
Syntaxe
linear-gradient([<angle> | to <côté>]?, <couleur> <position>?, <couleur> <position>?, …)

Variantes d’écriture

#
  • #7c3aed, #0ea5e9

    de haut en bas

    Deux couleurs sans direction. Par défaut, le dégradé va de haut en bas.
  • to right

    de gauche à droite

    Une direction exprimée par des mots : le dégradé va vers le bord droit.
  • 45deg

    en diagonale

    Un angle fait pivoter la ligne du dégradé. 45 degrés pointent vers le coin supérieur droit.
  • #7c3aed 30%, #0ea5e9 70%

    transition au milieu

    Des couleurs pures jusqu’à 30 % et à partir de 70 % de la longueur, avec la transition seulement entre les deux.
  • #7c3aed 50%, #0ea5e9 50%

    limite nette

    Deux couleurs à la même position. Au lieu d’une transition, on obtient une arête nette, comme sur un drapeau.
  • #f43f5e, #f59e0b, #10b981

    plusieurs couleurs

    Il peut y avoir autant de couleurs que l’on veut. Sans positions, le navigateur les répartit à intervalles réguliers.
  • repeating-linear-gradient()

    rayures

    Un motif répété à l’infini. Des limites nettes tous les 12 px donnent des rayures d’avertissement diagonales.
  • linear-gradient() + url()

    photo assombrie

    Deux couches d’arrière-plan : le dégradé recouvre la photo et assombrit sa partie basse. Sur un tel fond, il est facile de placer un texte lisible.

Variantes d’écriture en pratique

#

#7c3aed, #0ea5e9

Deux couleurs sans direction. Par défaut, le dégradé va de haut en bas.
.demo {
  background: linear-gradient(#7c3aed, #0ea5e9);
}

to right

Une direction exprimée par des mots : le dégradé va vers le bord droit.
.demo {
  background:
    linear-gradient(to right, #7c3aed, #0ea5e9);
}

45deg

Un angle fait pivoter la ligne du dégradé. 45 degrés pointent vers le coin supérieur droit.
.demo {
  background:
    linear-gradient(45deg, #7c3aed, #0ea5e9);
}

#7c3aed 30%, #0ea5e9 70%

Des couleurs pures jusqu’à 30 % et à partir de 70 % de la longueur, avec la transition seulement entre les deux.
.demo {
  background: linear-gradient(to right,
    #7c3aed 30%, #0ea5e9 70%);
}

#7c3aed 50%, #0ea5e9 50%

Deux couleurs à la même position. Au lieu d’une transition, on obtient une arête nette, comme sur un drapeau.
.demo {
  background: linear-gradient(to right,
    #7c3aed 50%, #0ea5e9 50%);
}

#f43f5e, #f59e0b, #10b981

Il peut y avoir autant de couleurs que l’on veut. Sans positions, le navigateur les répartit à intervalles réguliers.
.demo {
  background: linear-gradient(to right,
    #f43f5e, #f59e0b, #10b981);
}

repeating-linear-gradient()

Un motif répété à l’infini. Des limites nettes tous les 12 px donnent des rayures d’avertissement diagonales.
.demo {
  background: repeating-linear-gradient(45deg,
    #f59e0b 0 12px, #18181b 12px 24px);
}

linear-gradient() + url()

Deux couches d’arrière-plan : le dégradé recouvre la photo et assombrit sa partie basse. Sur un tel fond, il est facile de placer un texte lisible.
.demo {
  background:
    linear-gradient(transparent, #0c0c10),
    url("/collections/covers/vibe-coding.webp")
      center / cover;
}

Plus d’exemples

#
Texte rempli d’un dégradé
CSS
.title {
  background: linear-gradient(90deg, #a78bfa, #38bdf8);
  -webkit-background-clip: text;
  background-clip: text;
  color: transparent;
}
Aperçu

L’arrière-plan est découpé à la forme des lettres grâce à background-clip: text, et la couleur de texte transparente le révèle.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Un dégradé est une image : placez-le dans background ou background-image. Dans background-color, il sera ignoré.
  • Entre deux couleurs, vous pouvez insérer une simple position, par exemple #7c3aed, 20%, #0ea5e9. C’est une indication de l’endroit où la transition doit atteindre son milieu.
  • Dessinez rayures et drapeaux avec des limites nettes : deux couleurs à la même position, par exemple #000 50%, #fff 50%.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.