Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

radial-gradient(): color que se extiende desde un centro

Genera una imagen circular o elíptica con control sobre paradas de color, posición y extensión.

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

Sintaxis

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

radial-gradient() crea una imagen cuyos colores se propagan desde un centro siguiendo círculos o elipses. Úsala donde CSS acepte imágenes, como background-image, no como un valor de color. La forma, el tamaño y la posición describen la geometría; las paradas de color describen las transiciones. Sin forma ni tamaño explícitos, el valor habitual predeterminado es una elipse que alcanza la esquina más lejana.

En circle 20px at 50px 50px, 20px es el radio final, no el diámetro; el centro está a 50px del borde izquierdo y del superior. La parada del 100% se sitúa sobre ese círculo final. Dos paradas de color en la misma posición crean un límite brusco. La forma final no recorta la imagen: después de la última parada continúa su color. Si necesitas repetición, utiliza repeating-radial-gradient().

El ejemplo sitúa el rojo entre 0% y 50% y el azul entre 50% y 100%, por lo que el límite brusco queda en el radio de 10px. Un SVG generado con el elemento estilizado se dibuja en un canvas sin solicitudes de red. El píxel central es rojo; los píxeles a 15px en horizontal y vertical son azules. Otro a 40px también es azul, lo que demuestra que el radio final de 20px no es un borde de recorte.

Ejemplos

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

Resultado

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

La forma mostrada y los píxeles se verificaron en Chromium 157.0.8103.51. Las muestras evitan el borde suavizado; no se prueban todas las opciones recientes de interpolación de espacios de color.

Fuentes