An entrance that scales elements up into place on load or when they scroll into view.
Design
Build
Ship
Installation
Usage
import { Zoom, Zooms } from '@animate-ui/react/primitives/effects/zoom';
export function Hero() {
return (
<>
<Zoom>
<h1>Animated primitives for React</h1>
</Zoom>
{/* Staggered: each child starts 100ms after the previous one. */}
<Zooms holdDelay={100}>
<Card />
<Card />
<Card />
</Zooms>
</>
);
}With asChild, the animation is applied to your element instead of a wrapping div.
Animation
- The element scales from
initialScale(0.5 by default) toscaleon a spring (stiffness 200, damping 20), overshooting by about 2% before it settles. - Under reduced motion, it doesn't scale: it fades in instead.
inViewwaits for the element to scroll into view, once by default.<AnimateUIProvider tempo>paces the default spring.
API Reference
Zoom
| Prop | Type | Default |
|---|---|---|
asChild? | boolean | false |
initialScale? | number | 0.5 |
scale? | number | 1 |
delay? | number | 0 |
transition? | Transition | { type: 'spring', stiffness: 200, damping: 20 } |
inView? | boolean | false |
inViewOnce? | boolean | true |
inViewMargin? | string | '0px' |
...props? | HTMLMotionProps<'div'> | - |
Zooms
Wraps each child in a Zoom, delaying each one a little more than the previous.
| Prop | Type | Default |
|---|---|---|
children | React.ReactElement | React.ReactElement[] | - |
holdDelay? | number | 0 |
...props? | ZoomProps | - |