跳到正文
目录与搜索
⌘K

原语 / Animate UI

Effect · Animate UI

组合入场原语:在加载或进入视口时,同时应用淡入、模糊、滑动与缩放。

安装

自有原语直接来自 @animate-ui/react,不依赖 Radix UI、Base UI 或 React Aria;装上包即可使用。

终端
bun add @animate-ui/react motion

用法

直接从 @animate-ui/react 的对应子路径引入,下面就是完整示例;样式由你的类名决定。

effect.tsx
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 见上表。

属性类型默认值
asChildbooleanfalse
fadeboolean | { initialOpacity?: number; opacity?: number }false
blurboolean | { initialBlur?: number; blur?: number }false
slideboolean | { direction?: 'up' | 'down' | 'left' | 'right'; offset?: number }false
zoomboolean | { initialScale?: number; scale?: number }false
delaynumber0
transitionTransition{ type: 'spring', stiffness: 200, damping: 20 }
inViewbooleanfalse
inViewOncebooleantrue
inViewMarginstring'0px'
…propsHTMLMotionProps<'div'>—
childrenReact.ReactElement | React.ReactElement[]—
holdDelaynumber0
…propsEffectProps—

未列出的属性与上游 API 完全一致,可在 官方文档 查阅。

内容对应官方文档 2026-10-18 版本。