原语 / Animate UI
Highlight Text · Animate UI
像荧光笔一样从左侧扫入的文字背景。
安装
自有原语直接来自 @animate-ui/react,不依赖 Radix UI、Base UI 或 React Aria;装上包即可使用。
bun add @animate-ui/react motion用法
直接从 @animate-ui/react 的对应子路径引入,下面就是完整示例;样式由你的类名决定。
import { HighlightText } from '@animate-ui/react/primitives/texts/highlight';
export function Title() {
return (
<HighlightText
text="Highlight Text"
className="bg-linear-to-r from-blue-100 to-purple-100"
inView
/>
);
}动效
- 背景从左侧边缘生长,历时 2s,ease-in-out:起手慢、中段最快、落位时减速。
- 减少动效下直接显示完整背景。
所有时长都会乘以 AnimateUIProvider 的 tempo,并遵守系统的减少动效设置。
API
动效相关的 transition 与 exitTransition 是 Animate UI 唯一新增的属性;其余 props 见上表。
| 属性 | 类型 | 默认值 |
|---|---|---|
| text | string | — |
| delay | number | 0 |
| transition | Transition | { duration: 2, ease: 'easeInOut' } |
| inView | boolean | false |
| inViewMargin | string | '0px' |
| inViewOnce | boolean | true |
| …props | Omit<HTMLMotionProps<'span'>, 'children'> | — |
未列出的属性与上游 API 完全一致,可在 官方文档 查阅。
内容对应官方文档 2026-10-18 版本。