原语 / Animate UI
Tabs · Animate UI
Animate UI 自有的标签页:高亮在触发器之间滑动,面板横向滑入,容器高度跟随当前面板。
安装
自有原语直接来自 @animate-ui/react,不依赖 Radix UI、Base UI 或 React Aria;装上包即可使用。
bun add @animate-ui/react motion用法
直接从 @animate-ui/react 的对应子路径引入,下面就是完整示例;样式由你的类名决定。
import {
Tabs,
TabsContent,
TabsContents,
TabsHighlight,
TabsHighlightItem,
TabsList,
TabsTrigger,
} from '@animate-ui/react/primitives/tabs';
export function Settings() {
return (
<Tabs defaultValue="account">
<TabsHighlight className="absolute inset-0 rounded-md bg-background">
<TabsList className="flex rounded-lg bg-muted p-1">
<TabsHighlightItem value="account" className="flex-1">
<TabsTrigger value="account">Account</TabsTrigger>
</TabsHighlightItem>
<TabsHighlightItem value="password" className="flex-1">
<TabsTrigger value="password">Password</TabsTrigger>
</TabsHighlightItem>
</TabsList>
</TabsHighlight>
<TabsContents>
<TabsContent value="account">
Make changes to your account here.
</TabsContent>
<TabsContent value="password">Change your password here.</TabsContent>
</TabsContents>
</Tabs>
);
}动效
- 高亮以 stiffness 300 / damping 30 滑向选中项,一块表面从前一个触发器交接到新触发器,始终不透明。
- 面板并排滑动,临界阻尼弹簧 stiffness 300 / damping 35,不越过目标;容器高度同步跟随,非活动面板模糊 4px 并进入 inert。
所有时长都会乘以 AnimateUIProvider 的 tempo,并遵守系统的减少动效设置。
API
动效相关的 transition 与 exitTransition 是 Animate UI 唯一新增的属性;其余 props 见上表。
| 属性 | 类型 | 默认值 |
|---|---|---|
| defaultValue | string | — |
| value | string | — |
| onValueChange | (value: string) => void | — |
| orientation | 'horizontal' | 'vertical' | 'horizontal' |
| …props | React.ComponentProps<'div'> | — |
| transition | Transition | { type: 'spring', stiffness: 300, damping: 30 } |
| value | string | — |
| …props | React.ComponentProps<'div'> | — |
| asChild | boolean | false |
| value | string | — |
| …props | HTMLMotionProps<'button'> | — |
| transition | Transition | { type: 'spring', stiffness: 300, damping: 35, restDelta: 0.01 } |
| …props | HTMLMotionProps<'div'> | — |
| asChild | boolean | false |
| value | string | — |
| …props | HTMLMotionProps<'div'> | — |
未列出的属性与上游 API 完全一致,可在 官方文档 查阅。
内容对应官方文档 2026-10-18 版本。