Canvas Text – Aceternity UI 组件
Animated text with colorful curved lines on canvas.
@aceternity/canvas-text-demo
tsx
1"use client";
2import React from "react";
3import { motion, useMotionValue, useSpring } from "framer-motion";
4import { cn } from "@/lib/utils";
5
6export const CanvasText = ({
7 className,
8 children,
9 }) => {
10 const mouseX = useMotionValue(0);
11 const mouseY = useMotionValue(0);
12 const springConfig = { damping: 20, stiffness: 300 };
13 const x = useSpring(mouseX, springConfig);
14 const y = useSpring(mouseY, springConfig);
15
16 const handleMouseMove = (e) => {
17 mouseX.set(e.clientX - e.currentTarget.getBoundingClientRect().left);
18 mouseY.set(e.clientY - e.currentTarget.getBoundingClientRect().top);
19 };
20
21 return (
22 <motion.div
23 onMouseMove={handleMouseMove}
24 className={cn("group relative overflow-hidden", className)}
25 >
26 <motion.div
27 className="pointer-events-none absolute -inset-px opacity-0 transition-opacity group-hover:opacity-100"
28 style={{
29 background: `radial-gradient(300px circle at ${x}px ${y}px, rgba(168,85,247,0.1), transparent 80%)`,
30 }}
31 />
32 {children}
33 </motion.div>
34 );
35};
Installation
npx shadcn@latest add @aceternity/canvas-text
npm install framer-motion clsx tailwind-mergeAnimated text with colorful curved lines on canvas.
概述
Canvas Text 是 Aceternity UI 组件库中的一个精选组件，专为 React + Tailwind CSS 项目设计。它提供了流畅的动画效果和现代化的视觉体验，可以轻松集成到你的项目中。
特性
- React + TypeScript 支持，类型安全
- Tailwind CSS 样式，响应式设计
- Framer Motion 动画引擎，流畅自然
- 复制即用，无需额外安装依赖
- 暗色模式兼容
- SSR/SSG友好，支持 Next.js
使用场景
- 产品落地页 - 为你的产品页面添加视觉冲击力
- 后台管理系统 - 提升管理界面的用户体验
- 个人作品集 - 展示你的技术实力
- SaaS 应用 - 为用户提供现代化的界面
- 内容展示 - 以引人入胜的方式展示内容
技术栈
- React 18+
- Tailwind CSS 3+
- Framer Motion / Motion
- TypeScript（可选）
兼容性
| 框架 | 支持状态 |
|---|---|
| Next.js 14+ | 完全支持 |
| Vite + React | 完全支持 |
| Create React App | 支持 |
| Remix | 支持 |
| Astro + React | 支持 |
- 确保已安装
framer-motion和tailwindcss - 组件使用
"use client"指令，适用于 App Router - 所有组件均支持暗色模式
- 建议在
tailwind.config.js中配置cn工具函数
Examples
Basic Usage
@aceternity/canvas-text-demo
tsx
1"use client";
2import React from "react";
3import { motion } from "framer-motion";
4
5export const CanvasText = ({ text, className }) => {
6 const words = text.split(" ");
7 return (
8 <motion.h1 className={className}>
9 {words.map((word, i) => (
10 <motion.span
11 key={i}
12 initial={{ opacity: 0, filter: "blur(10px)" }}
13 animate={{ opacity: 1, filter: "blur(0px)" }}
14 transition={{ delay: i * 0.1 }}
15 className="inline-block mr-2"
16 >
17 {word}
18 </motion.span>
19 ))}
20 </motion.h1>
21 );
22};
With Custom Props
@aceternity/canvas-text-custom-demo
tsx
1"use client";
2import React from "react";
3import { motion, useMotionValue, useTransform, useSpring } from "framer-motion";
4
5export const CanvasText = ({ children, className }) => {
6 const x = useMotionValue(0);
7 const y = useMotionValue(0);
8 const rotateX = useTransform(y, [-100, 100], [10, -10]);
9 const rotateY = useTransform(x, [-100, 100], [-10, 10]);
10 const springX = useSpring(rotateX, { damping: 20 });
11 const springY = useSpring(rotateY, { damping: 20 });
12
13 return (
14 <motion.div
15 onMouseMove={(e) => {
16 const rect = e.currentTarget.getBoundingClientRect();
17 x.set(e.clientX - rect.left - rect.width / 2);
18 y.set(e.clientY - rect.top - rect.height / 2);
19 }}
20 onMouseLeave={() => { x.set(0); y.set(0); }}
21 style={{ rotateX: springX, rotateY: springY, transformPerspective: 1000 }}
22 className={className}
23 >
24 {children}
25 </motion.div>
26 );
27};
Props
| Prop | Type | Default | Description | Required |
|---|---|---|---|---|
className |
string |
"" |
Additional CSS classes | No |
children |
React.ReactNode |
- |
Child elements | Yes |
duration |
number |
0.5 |
Animation duration in seconds | No |
delay |
number |
0 |
Animation delay in seconds | No |
color |
string |
"#a855f7" |
Primary color | No |
disabled |
boolean |
false |
Disable interactions | No |
