conic-gradient()

Crée une transition de couleurs autour d’un point, comme l’aiguille d’une horloge. Sert aux graphiques circulaires, cercles chromatiques et bordures tournantes.

Sur cette page

Exemple

#
CSS
.chart {
  width: 120px;
  aspect-ratio: 1;
  border-radius: 50%;
  background: conic-gradient(
    #7c3aed 0 40%,
    #0ea5e9 0 75%,
    #10b981 0
  );
}
Aperçu

Chaque couleur commence à 0, c’est-à-dire là où la précédente s’est terminée. Il suffit d’indiquer jusqu’où elle doit aller.

Définition et utilisation

#

La fonction conic-gradient() répartit les couleurs sur un cercle autour du centre, dans le sens des aiguilles d’une montre, en partant du haut. La couleur change avec l’angle, et non avec la distance au centre comme dans radial-gradient(). Le résultat est une image : vous la placez donc dans background ou background-image.

Vous donnez les positions des couleurs en degrés ou en pourcentages d’un tour complet : #7c3aed 0deg 120deg remplit un tiers du cercle. Deux couleurs à la même position donnent une limite nette : à partir de plusieurs plages, vous construisez ainsi un graphique circulaire sans aucune image. Avec border-radius: 50%, l’élément devient rond.

Le mot from fait pivoter le point de départ (from 90deg commence à droite), et at déplace le centre (at 30% 40%). Pour un cercle chromatique fluide, la dernière couleur doit être identique à la première, sinon une arête nette apparaît en haut.

La version repeating-conic-gradient() répète le motif, ce qui permet de dessiner un damier en une seule déclaration, par exemple repeating-conic-gradient(#27272a 0 25%, #3f3f46 0 50%) avec background-size. En animant l’angle from via une variable enregistrée avec @property, vous pouvez créer une bordure tournante ou un indicateur de chargement.

Syntaxe

#
Syntaxe
conic-gradient([from <angle>]? [at <position>]?, <couleur> <angle>?, <couleur> <angle>?, …)

Variantes d’écriture

#
  • cercle chromatique

    rotation fluide des couleurs

    Des couleurs d’arc-en-ciel réparties autour du centre. La dernière est identique à la première : il n’y a donc pas d’arête nette en haut.
  • from 90deg

    départ à droite

    Le mot from fait pivoter le point de départ. Le quart ambré commence à trois heures au lieu de midi.
  • at 30% 30%

    centre décalé

    Après at, vous donnez la position du centre. Les couleurs convergent dans la partie supérieure gauche du cercle.
  • graphique circulaire

    40 %, 35 % et 25 %

    Des plages nettes au lieu de transitions. Chaque couleur commence à 0, c’est-à-dire là où la précédente s’est terminée.
  • anneau de progression

    65 %

    Une portion de 65 % sur fond gris, et un masque à dégradé radial découpe le centre : il ne reste du disque qu’un anneau.
  • repeating-conic-gradient()

    damier

    Un motif répété de deux quarts dans une tuile de 22 × 22 px. C’est ainsi qu’on dessine un damier, par exemple sous des images transparentes.

Variantes d’écriture en pratique

#

cercle chromatique

Des couleurs d’arc-en-ciel réparties autour du centre. La dernière est identique à la première : il n’y a donc pas d’arête nette en haut.
.demo {
  background: conic-gradient(red, yellow, lime,
    aqua, blue, magenta, red);
}

from 90deg

Le mot from fait pivoter le point de départ. Le quart ambré commence à trois heures au lieu de midi.
.demo {
  background: conic-gradient(from 90deg,
    #f59e0b 0 25%, #27272a 0);
}

at 30% 30%

Après at, vous donnez la position du centre. Les couleurs convergent dans la partie supérieure gauche du cercle.
.demo {
  background: conic-gradient(at 30% 30%,
    #7c3aed, #0ea5e9, #10b981, #7c3aed);
}

graphique circulaire

Des plages nettes au lieu de transitions. Chaque couleur commence à 0, c’est-à-dire là où la précédente s’est terminée.
.demo {
  background: conic-gradient(#7c3aed 0 40%,
    #0ea5e9 0 75%, #10b981 0);
}

anneau de progression

Une portion de 65 % sur fond gris, et un masque à dégradé radial découpe le centre : il ne reste du disque qu’un anneau.
.demo {
  background:
    conic-gradient(#10b981 65%, #27272a 0);
  mask: radial-gradient(closest-side,
    transparent 68%, #000 69%);
}

repeating-conic-gradient()

Un motif répété de deux quarts dans une tuile de 22 × 22 px. C’est ainsi qu’on dessine un damier, par exemple sous des images transparentes.
.demo {
  border-radius: 12px;
  background: repeating-conic-gradient(
    #27272a 0 25%, #a1a1aa 0 50%) 0 0 / 22px 22px;
}

Compatibilité des navigateurs

#

Largement disponible · depuis 2020

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

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Dans les graphiques circulaires, donnez la position de départ sous la forme 0 : le navigateur commence la couleur là où la précédente s’est terminée, et il n’y a pas à répéter les nombres.
  • Un graphique fait en CSS n’est pas lisible par les lecteurs d’écran. Ajoutez à côté une légende avec les valeurs, ou une description dans aria-label.
  • Vous pouvez faire tourner un dégradé en animant from var(--angle) avec une variable enregistrée via @property en tant que <angle>.

Entrées associées

#

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