Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

radial-gradient(): colore che si espande da un centro

Genera un’immagine circolare o ellittica controllando le posizioni dei colori, la posizione e l’estensione.

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

Sintassi

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

radial-gradient() crea un’immagine i cui colori si espandono da un centro lungo cerchi o ellissi. Usala dove CSS accetta un’immagine, ad esempio in background-image, non come valore di colore. Forma, dimensione e posizione descrivono la geometria; gli arresti di colore descrivono le transizioni. Senza forma e dimensione esplicite, il normale valore predefinito è un’ellisse che raggiunge l’angolo più lontano.

In circle 20px at 50px 50px, 20px indica il raggio finale, non il diametro; il centro si trova a 50px dai bordi sinistro e superiore. L’arresto al 100% è su quel cerchio finale. Due arresti di colore nella stessa posizione creano un confine netto. La forma finale non ritaglia l’immagine: oltre l’ultimo arresto continua il suo colore. Per ottenere una ripetizione, usa repeating-radial-gradient().

L’esempio dispone il rosso tra 0% e 50% e il blu tra 50% e 100%: il confine netto è quindi al raggio di 10px. Un SVG generato con l’elemento stilizzato viene disegnato in un canvas senza richieste di rete. Il pixel centrale è rosso; quelli a 15px in orizzontale e in verticale sono blu. Anche un pixel distante 40px è blu, dimostrando che il raggio finale di 20px non è un bordo di ritaglio.

Esempi

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));

Risultato

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

Forma e pixel mostrati sono verificati in Chromium 157.0.8103.51. I campioni evitano il bordo con antialiasing; non vengono provate tutte le nuove opzioni d’interpolazione degli spazi colore.

Fonti