Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

radial-gradient() : des couleurs qui partent d’un centre

Générez une image circulaire ou elliptique en maîtrisant les arrêts de couleur, la position et l’étendue.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

background-image: radial-gradient(circle 20px at 50px 50px, red 0% 50%, blue 50% 100%);

radial-gradient() crée une image dont les couleurs se propagent depuis un centre selon des cercles ou des ellipses. Utilisez-la là où CSS accepte une image, comme background-image, et non comme valeur de couleur. La forme, la taille et la position décrivent la géométrie ; les arrêts de couleur décrivent les transitions. Sans forme ni taille explicites, le choix habituel par défaut est une ellipse atteignant le coin le plus éloigné.

Dans circle 20px at 50px 50px, 20px est le rayon final, pas le diamètre ; le centre est situé à 50px des bords gauche et supérieur. L’arrêt à 100% se trouve sur ce cercle final. Deux arrêts de couleur à la même position produisent une frontière nette. La forme finale ne découpe pas l’image : la dernière couleur se prolonge après le dernier arrêt. Pour une répétition, utilisez repeating-radial-gradient().

L’exemple répartit le rouge sur 0%–50% et le bleu sur 50%–100% : la frontière nette est donc au rayon 10px. Un SVG généré contenant l’élément stylé est dessiné dans un canvas sans requête réseau. Le pixel central est rouge ; les pixels situés à 15px horizontalement et verticalement sont bleus. Un pixel à 40px est aussi bleu, ce qui prouve que le rayon final de 20px ne constitue pas un bord de découpage.

Exemples

const value='radial-gradient(circle 20px at 50px 50px, red 0% 50%, blue 50% 100%)';
const svg='<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"><foreignObject width="100" height="100"><div xmlns="http://www.w3.org/1999/xhtml" style="width:100px;height:100px;background:'+value+'"></div></foreignObject></svg>';
const image=new Image();image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);await image.decode();
const canvas=document.createElement('canvas');canvas.width=canvas.height=100;const ctx=canvas.getContext('2d');ctx.drawImage(image,0,0);
const pixel=(x,y)=>[...ctx.getImageData(x,y,1,1).data].slice(0,3).join(',');
console.log('center='+pixel(50,50)+'; horizontal='+pixel(65,50)+'; vertical='+pixel(50,65)+'; outside-radius='+pixel(90,50)+'; color-property='+CSS.supports('color',value));

Résultat

center=255,0,0; horizontal=0,0,255; vertical=0,0,255; outside-radius=0,0,255; color-property=false

La forme présentée et les pixels ont été vérifiés dans Chromium 157.0.8103.51. Les points évitent la frontière anticrénelée ; le test ne couvre pas toutes les nouvelles options d’interpolation des espaces colorimétriques.

Sources