跳到正文
目录与搜索
⌘K

原语 / 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 的对应子路径引入,下面就是完整示例;样式由你的类名决定。

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

属性类型默认值
defaultValuestring—
valuestring—
onValueChange(value: string) => void—
orientation'horizontal' | 'vertical''horizontal'
…propsReact.ComponentProps<'div'>—
transitionTransition{ type: 'spring', stiffness: 300, damping: 30 }
valuestring—
…propsReact.ComponentProps<'div'>—
asChildbooleanfalse
valuestring—
…propsHTMLMotionProps<'button'>—
transitionTransition{ type: 'spring', stiffness: 300, damping: 35, restDelta: 0.01 }
…propsHTMLMotionProps<'div'>—
asChildbooleanfalse
valuestring—
…propsHTMLMotionProps<'div'>—

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

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