原语 / Animate UI
Effect · Animate UI
组合入场原语:在加载或进入视口时,同时应用淡入、模糊、滑动与缩放。
安装
自有原语直接来自 @animate-ui/react,不依赖 Radix UI、Base UI 或 React Aria;装上包即可使用。
bun add @animate-ui/react motion用法
直接从 @animate-ui/react 的对应子路径引入,下面就是完整示例;样式由你的类名决定。
import { Effect, Effects } from '@animate-ui/react/primitives/effects/effect';
export function Hero() {
return (
<>
<Effect fade blur slide zoom>
<h1>Animated primitives for React</h1>
</Effect>
{/* Staggered: each child starts 100ms after the previous one. */}
<Effects holdDelay={100} fade blur slide zoom>
<Card />
<Card />
<Card />
</Effects>
</>
);
}动效
- fade、blur、slide、zoom 可任意组合;传 true 使用各自默认值,传对象则逐项自定义。
- 所有效果共用同一条弹簧与同一个触发时机;减少动效下只保留最终状态。
所有时长都会乘以 AnimateUIProvider 的 tempo,并遵守系统的减少动效设置。
API
动效相关的 transition 与 exitTransition 是 Animate UI 唯一新增的属性;其余 props 见上表。
| 属性 | 类型 | 默认值 |
|---|---|---|
| asChild | boolean | false |
| fade | boolean | { initialOpacity?: number; opacity?: number } | false |
| blur | boolean | { initialBlur?: number; blur?: number } | false |
| slide | boolean | { direction?: 'up' | 'down' | 'left' | 'right'; offset?: number } | false |
| zoom | boolean | { initialScale?: number; scale?: number } | false |
| delay | number | 0 |
| transition | Transition | { type: 'spring', stiffness: 200, damping: 20 } |
| inView | boolean | false |
| inViewOnce | boolean | true |
| inViewMargin | string | '0px' |
| …props | HTMLMotionProps<'div'> | — |
| children | React.ReactElement | React.ReactElement[] | — |
| holdDelay | number | 0 |
| …props | EffectProps | — |
未列出的属性与上游 API 完全一致,可在 官方文档 查阅。
内容对应官方文档 2026-10-18 版本。