Toggle Sidebar B
AppearanceLight & dark mode D

Orbit Images

SVG path customizable orbiting images effect.

Default

Pick a shape, then change the radius, rotation and speed. Every prop is wired to the controls underneath.

Dark previewReplay previewOpen in new tab

Customize

Shape
Direction
Radius X340px
Radius Y80px
Radius160px
Rotation-8°
Duration30s
Item Size80px

API Reference

OrbitImages

PropTypeDefaultDescription
imagesstring[][]Array of image URLs to orbit along the path.
altPrefixstring"Orbiting image"Prefix for auto-generated alt attributes.
shapestring"ellipse"Preset shape: ellipse, circle, square, rectangle, triangle, star, heart, infinity, wave, or custom.
customPathstringundefinedCustom SVG path string (used when shape="custom").
baseWidthnumber1400Base width for the design coordinate space used for responsive scaling.
radiusXnumber700Horizontal radius for ellipse/rectangle shapes.
radiusYnumber170Vertical radius for ellipse/rectangle shapes.
radiusnumber300Radius for circle, square, triangle, star, heart shapes.
starPointsnumber5Number of points for star shape.
starInnerRationumber0.5Inner radius ratio for star (0-1).
rotationnumber-8Rotation angle of the entire orbit path in degrees.
durationnumber40Duration of one complete orbit in seconds.
itemSizenumber64Width/height of each orbiting item in pixels.
directionstring"normal"Animation direction: "normal" or "reverse".
fillbooleantrueWhether to distribute items evenly around the orbit.
widthnumber | "100%"100Container width in pixels or "100%".
heightnumber | "auto"100Container height in pixels or "auto".
showPathbooleanfalseWhether to show the orbit path for debugging.
pathColorstring"rgba(0,0,0,0.1)"Stroke color when showPath is true.
pathWidthnumber2Stroke width when showPath is true.
easingstring"linear"Animation easing: linear, easeIn, easeOut, easeInOut.
pausedbooleanfalseWhether the animation is paused.
center (slot)VNodeundefinedCustom content rendered at the center of the orbit.
responsivebooleanfalseEnable responsive scaling based on container width.

Accessibility

Keyboard shortcuts and ARIA behavior.

  • The component is decorative and marked aria-hidden, so screen readers skip it.