跳到正文
目录与搜索
⌘K

原语 / Animate UI

Slide · Animate UI

入场原语:在加载或进入视口时把元素滑到位置。

安装

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

终端
bun add @animate-ui/react motion

用法

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

slide.tsx
import { Slide, Slides } from '@animate-ui/react/primitives/effects/slide';

export function Hero() {
  return (
    <>
      <Slide direction="up">
        <h1>Animated primitives for React</h1>
      </Slide>

      {/* Staggered: each child starts 100ms after the previous one. */}
      <Slides holdDelay={100} direction="up">
        <Card />
        <Card />
        <Card />
      </Slides>
    </>
  );
}

动效

  • 元素沿 offset 像素(默认 100)滑入,弹簧 stiffness 200 / damping 20,约 4% 过冲后落定。
  • 位移使用硬件加速的 transform;减少动效下直接到位。

所有时长都会乘以 AnimateUIProvider 的 tempo,并遵守系统的减少动效设置。

API

动效相关的 transition 与 exitTransition 是 Animate UI 唯一新增的属性;其余 props 见上表。

属性类型默认值
asChildbooleanfalse
direction'up' | 'down' | 'left' | 'right''up'
offsetnumber100
delaynumber0
transitionTransition{ type: 'spring', stiffness: 200, damping: 20 }
inViewbooleanfalse
inViewOncebooleantrue
inViewMarginstring'0px'
…propsHTMLMotionProps<'div'>—
childrenReact.ReactElement | React.ReactElement[]—
holdDelaynumber0
…propsSlideProps—

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

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