- Docs
- Components
- Images & Galleries
- Galleries & Carousels
- Liquid Circles
Concentric rings of photo circles that melt into liquid glass at the edges
| Name | Type | Default | Description |
|---|---|---|---|
images | string[] | demo photos | Image URLs shown on the circles. They repeat when there are more circles than images. |
count | number | 20 | Number of circles across all rings. |
rings | number | 2 | Number of concentric rings the circles sit on. |
size | number | 0.22 | Circle diameter, relative to the ring. |
sizeVariance | number | 0 | How much circle sizes vary from one to the next. |
radius | number | 0.5 | Corner radius of each image as a fraction of its size. 0.5 is a circle, smaller values give rounded squares, 0 is a square. |
reach | number | 0.79 | How far the outer ring reaches toward the sides, as a fraction of half the width. |
spread | number | 0.36 | Gap between the outer and inner rings, as a fraction of the outer ring. |
depth | number | 0 | Scatters circles in and out of the ring's plane. |
tilt | number | 46 | How far the ring leans back, in degrees. |
angle | number | 10 | Direction of the lean in degrees, measured from the frame's diagonal. |
perspective | number | 20 | Horizontal field of view in degrees. Higher values exaggerate depth. |
speed | number | 7 | Rotation speed in degrees per second. Negative values turn the other way. |
refraction | number | 1 | Strength of the liquid glass at the edges. 0 turns it off. |
edge | number | 0.24 | Width of the liquid glass band around the frame, as a fraction of the frame. |
edges | "all" | "sides" | "all" | Bend the circles at every edge of the frame, or only at the left and right. |
dispersion | number | 0.3 | How far the colours split apart as the glass bends the image. |
blur | number | 0.5 | How much the stretched streaks soften toward the edge. |
flow | number | 0.8 | How much the stretched streaks fan out and drift like liquid. |
backgroundColor | string | "#FFFFFF" | Colour behind the circles. |
interactive | boolean | true | Drag to spin the rings, with momentum. |
wheel | boolean | true | Scrolling over the rings spins them. Set false to leave page scrolling untouched. |
focus | boolean | true | Hovering a circle turns it to face you and slows the rings. |
intro | boolean | true | The rings bloom out from the centre the first time they come into view. |
seed | number | 3 | Changes the size and depth scatter. |
onCircleClick | (index: number, src: string) => void | — | Called with the circle's index and image when a circle is clicked. |
ref | { replay, spinBy } | — | Replays the intro, or spins the rings by a number of degrees. |
className | string | — | Classes for the root element. |
style | CSSProperties | — | Inline styles for the root element. |
imagesstring[]Image URLs shown on the circles. They repeat when there are more circles than images.
demo photoscountnumberNumber of circles across all rings.
20ringsnumberNumber of concentric rings the circles sit on.
2sizenumberCircle diameter, relative to the ring.
0.22sizeVariancenumberHow much circle sizes vary from one to the next.
0radiusnumberCorner radius of each image as a fraction of its size. 0.5 is a circle, smaller values give rounded squares, 0 is a square.
0.5reachnumberHow far the outer ring reaches toward the sides, as a fraction of half the width.
0.79spreadnumberGap between the outer and inner rings, as a fraction of the outer ring.
0.36depthnumberScatters circles in and out of the ring's plane.
0tiltnumberHow far the ring leans back, in degrees.
46anglenumberDirection of the lean in degrees, measured from the frame's diagonal.
10perspectivenumberHorizontal field of view in degrees. Higher values exaggerate depth.
20speednumberRotation speed in degrees per second. Negative values turn the other way.
7refractionnumberStrength of the liquid glass at the edges. 0 turns it off.
1edgenumberWidth of the liquid glass band around the frame, as a fraction of the frame.
0.24edges"all" | "sides"Bend the circles at every edge of the frame, or only at the left and right.
"all"dispersionnumberHow far the colours split apart as the glass bends the image.
0.3blurnumberHow much the stretched streaks soften toward the edge.
0.5flownumberHow much the stretched streaks fan out and drift like liquid.
0.8backgroundColorstringColour behind the circles.
"#FFFFFF"interactivebooleanDrag to spin the rings, with momentum.
truewheelbooleanScrolling over the rings spins them. Set false to leave page scrolling untouched.
truefocusbooleanHovering a circle turns it to face you and slows the rings.
trueintrobooleanThe rings bloom out from the centre the first time they come into view.
trueseednumberChanges the size and depth scatter.
3onCircleClick(index: number, src: string) => voidCalled with the circle's index and image when a circle is clicked.
—ref{ replay, spinBy }Replays the intro, or spins the rings by a number of degrees.
—classNamestringClasses for the root element.
—styleCSSPropertiesInline styles for the root element.
—