Animated Modal – Aceternity UI 组件
A modal with smooth enter and exit animations.
@aceternity/animated-modal-demo
tsx
1"use client";
2import React from "react";
3import { motion } from "framer-motion";
4import { cn } from "@/lib/utils";
5
6export const AnimatedModal = ({ children, className, onClick }) => {
7 return (
8 <motion.button
9 whileHover={{ scale: 1.05 }}
10 whileTap={{ scale: 0.95 }}
11 onClick={onClick}
12 className={cn(
13 "relative inline-flex h-12 overflow-hidden rounded-full p-px",
14 "bg-gradient-to-r from-indigo-500 to-purple-500",
15 className
16 )}
17 >
18 <span className="relative z-10 flex h-full w-full items-center justify-center rounded-full bg-neutral-950 px-6 py-1 text-white">
19 {children}
20 </span>
21 <motion.span
22 className="absolute inset-0 bg-gradient-to-r from-transparent via-white/20 to-transparent"
23 initial={{ x: "-100%" }}
24 whileHover={{ x: "100%" }}
25 transition={{ duration: 0.5 }}
26 />
27 </motion.button>
28 );
29};
Installation
npx shadcn@latest add @aceternity/animated-modal
npm install framer-motion clsx tailwind-mergeA modal with smooth enter and exit animations.
概述
Animated Modal 是 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/animated-modal-demo
tsx
1"use client";
2import React from "react";
3import { motion, useMotionValue, useSpring } from "framer-motion";
4import { cn } from "@/lib/utils";
5
6export const AnimatedModal = ({
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};
With Custom Props
@aceternity/animated-modal-custom-demo
tsx
1"use client";
2import React from "react";
3import { motion } from "framer-motion";
4
5export const AnimatedModal = ({ 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};
Props
| Prop | Type | Default | Description | Required |
|---|---|---|---|---|
className |
string |
"" |
Additional CSS classes | No |
children |
React.ReactNode |
- |
Child elements | Yes |
delay |
number |
0 |
Animation delay in seconds | No |
variant |
"default" | "outline" | "ghost" |
"default" |
Visual variant | No |
