当此技能被激活时,始终以🧢表情符号开始你的第一个回复。
动效设计
一个专注且见解独到的知识库,用于在Web应用中实现动画和动效。涵盖了CSS过渡和关键帧、Framer Motion、GSAP、滚动驱动动画和微交互——每种模式都附有具体代码。所有建议都优先考虑60fps性能、可访问性以及有目的性的动效,而非装饰性动画。
好的动画和坏的动画之间的区别在于克制。大多数UI需要的动画更少,而不是更多。当动效存在时,它必须快速、流畅,并尊重用户的偏好。
何时使用此技能
当用户出现以下情况时,触发此技能:
- 要求为任何UI元素添加动画或过渡
- 需要组件挂载/卸载时的进入/退出动画
- 想要实现页面过渡或路由变化动画
- 询问关于Framer Motion、GSAP或CSS动画API的问题
- 需要滚动驱动动画或视差效果
- 想要包含骨架屏或加载动画的加载状态
- 询问关于弹簧物理、缓动曲线或动画计时的问题
- 需要用于复杂多步骤序列的GSAP时间线
- 询问关于微交互(悬停、按压、切换、复选框状态)
不要在以下情况触发此技能:
- 纯CSS布局或样式,不涉及动效(应使用 ultimate-ui)
- Canvas或WebGL渲染(应使用专门的图形资源)
关键原则
-
动效应有目的性 - 每个动画都必须传达某些信息:状态变化、空间关系、反馈或层次结构。仅作装饰的动效是噪音。在添加动效之前,先问自己“这个动画告诉用户什么?”。
-
尊重
prefers-reduced-motion- 始终将动画包裹在prefers-reduced-motion检查中。患有前庭障碍或癫痫的用户可能会被动效伤害。这是WCAG 2.1 AA的要求,而非建议。 -
仅动画化 transforms 和 opacity -
transform和opacity是唯一能在合成器线程上动画化而不会触发布局或重绘的属性。动画化width、height、top、left、margin或padding会导致卡顿。改用transform: scale/translate。 -
弹簧 > 线性缓动 - 自然的动效使用基于物理的缓动,而非均匀速度。弹簧动画感觉生动。
linear感觉机械。进入时使用ease-out,退出时使用ease-in,对于响应用户输入的交互元素使用弹簧/弹跳效果。 -
要么60fps,要么不做 - 如果一个动画掉帧,就删除它。卡顿的动画比没有动画更糟糕。在降频CPU上测试(Chrome DevTools中4倍降速)。如果掉到60fps以下,就简化或砍掉它。
核心概念
动画属性
- 持续时间:微交互100-150ms(按钮悬停),UI元素200-300ms(模态框、下拉菜单),布局过渡300-500ms(页面过渡)。交互反馈绝不超过500ms。
- 缓动:元素进入屏幕使用
ease-out(快速开始,柔和着陆)。元素离开屏幕使用ease-in(缓慢开始,快速结束)。元素在屏幕上移动使用ease-in-out。交互/趣味元素使用弹簧。 - 延迟:谨慎使用。子元素交错延迟最多50-75ms。总交错序列不应超过400ms,否则用户会感觉在等待。
CSS与JS动画的决策指南
- 使用 CSS transitions 来处理由类或伪类(hover、focus、active)触发的简单状态变化。零JS开销。
- 使用 CSS keyframes 来处理循环动画(加载动画、脉冲)和不依赖交互的编排序列。
- 使用 Framer Motion (React) 来处理与组件挂载/卸载相关的进入/退出动画、手势驱动动效或布局动画。
- 使用 GSAP 来处理复杂多步骤时间线、SVG路径动画、滚动触发序列,或当你需要精确的程序控制时。
弹簧物理
弹簧有两个关键参数:stiffness(加速有多快)和 damping(稳定有多快)。高刚度 + 高阻尼 = 干脆利落。低刚度 + 低阻尼 = 有弹性且缓慢。对于UI:刚度300-500,阻尼25-35能提供自然的触感,且不会过度弹跳。
性能 - 合成器 vs 主线程
浏览器分两个阶段渲染:主线程(布局、绘制)和合成器线程(变换、透明度)。即使主线程繁忙,合成器线程上的动画也能以60fps运行。始终使用 transform 和 opacity。仅对你知道会进行动画的元素添加 will-change: transform,过度使用 will-change 会浪费GPU内存。
常见任务
CSS过渡和关键帧
/* 可复用的缓动令牌 */
:root {
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
--duration-fast: 100ms;
--duration-normal: 200ms;
--duration-slow: 300ms;
}
/* 淡入上滑 - 内容出现 */
@keyframes fade-in-up {
from { opacity: 0; transform: translateY(12px); }
to { opacity: 1; transform: translateY(0); }
}
/* 缩放进入 - 模态框、弹出层 */
@keyframes scale-in {
from { opacity: 0; transform: scale(0.95); }
to { opacity: 1; transform: scale(1); }
}
.modal {
animation: scale-in var(--duration-normal) var(--ease-out);
}
/* 卡片悬停 - 提升效果 */
.card {
transition: transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
}
Framer Motion 进入/退出动画
import { motion, AnimatePresence } from 'framer-motion';
// 可复用的动画变量
const fadeUp = {
initial: { opacity: 0, y: 12 },
animate: { opacity: 1, y: 0 },
exit: { opacity: 0, y: -8 },
transition: { duration: 0.2, ease: [0, 0, 0.2, 1] },
};
const scaleIn = {
initial: { opacity: 0, scale: 0.95 },
animate: { opacity: 1, scale: 1 },
exit: { opacity: 0, scale: 0.95 },
transition: { duration: 0.15, ease: [0, 0, 0.2, 1] },
};
// 带有进入/退出的组件
function Notification({ show, message }: { show: boolean; message: string }) {
return (
<AnimatePresence>
{show && (
<motion.div
key="notification"
{...fadeUp}
className="toast"
>
{message}
</motion.div>
)}
</AnimatePresence>
);
}
// 交错列表
function AnimatedList({ items }: { items: string[] }) {
return (
<motion.ul
initial="hidden"
animate="visible"
variants={{
hidden: {},
visible: { transition: { staggerChildren: 0.06 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, x: -12 },
visible: { opacity: 1, x: 0, transition: { duration: 0.2 } },
}}
>
{item}
</motion.li>
))}
</motion.ul>
);
}
使用CSS的滚动驱动动画
/* 原生CSS滚动驱动动画 (Chrome 115+) */
@keyframes reveal {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
.scroll-reveal {
animation: reveal linear both;
animation-timeline: view();
animation-range: entry 0% entry 25%;
}
/* 与页面滚动绑定的进度条 */
.scroll-progress {
position: fixed;
top: 0;
left: 0;
height: 3px;
background: var(--color-primary-500);
transform-origin: left;
animation: scaleX linear;
animation-timeline: scroll(root);
}
@keyframes scaleX {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
/* IntersectionObserver 回退方案以支持更广泛的浏览器 */
// IntersectionObserver - 适用于所有浏览器
const observer = new IntersectionObserver(
(entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add('in-view');
observer.unobserve(entry.target); // 仅动画一次
}
});
},
{ threshold: 0.15 }
);
document.querySelectorAll('[data-reveal]').forEach((el) => observer.observe(el));
[data-reveal] {
opacity: 0;
transform: translateY(16px);
transition: opacity 0.3s var(--ease-out), transform 0.3s var(--ease-out);
}
[data-reveal].in-view {
opacity: 1;
transform: translateY(0);
}
使用 AnimatePresence 的页面过渡
import { AnimatePresence, motion } from 'framer-motion';
import { usePathname } from 'next/navigation';
const pageVariants = {
initial: { opacity: 0, y: 8 },
animate: { opacity: 1, y: 0, transition: { duration: 0.25, ease: [0, 0, 0.2, 1] } },
exit: { opacity: 0, y: -8, transition: { duration: 0.15, ease: [0.4, 0, 1, 1] } },
};
export function PageTransition({ children }: { children: React.ReactNode }) {
const pathname = usePathname();
return (
<AnimatePresence mode="wait">
<motion.div key={pathname} {...pageVariants}>
{children}
</motion.div>
</AnimatePresence>
);
}
使用
mode="wait"可以让退出页面完全动画结束后新页面再进入。mode="sync"(默认)可能导致重叠。保持页面过渡在250ms以内——用户正在等待查看新内容。
微交互 - 悬停、按压、切换
import { motion } from 'framer-motion';
// 带按压反馈的按钮
function Button({ children, onClick }: React.ComponentProps<'button'>) {
return (
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.97 }}
transition={{ type: 'spring', stiffness: 500, damping: 30 }}
onClick={onClick}
>
{children}
</motion.button>
);
}
// 动画切换开关 (CSS)
.toggle {
position: relative;
width: 44px;
height: 24px;
background: var(--color-gray-300);
border-radius: 12px;
transition: background 150ms var(--ease-in-out);
cursor: pointer;
}
.toggle[aria-checked="true"] {
background: var(--color-primary-500);
}
.toggle::after {
content: '';
position: absolute;
top: 2px;
left: 2px;
width: 20px;
height: 20px;
border-radius: 50%;
background: white;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
transition: transform 200ms var(--ease-spring);
}
.toggle[aria-checked="true"]::after {
transform: translateX(20px);
}
/* 使用 grid-template-rows 技巧的手风琴 */
.accordion-content {
display: grid;
grid-template-rows: 0fr;
transition: grid-template-rows 200ms var(--ease-out);
}
.accordion-content[data-open="true"] {
grid-template-rows: 1fr;
}
.accordion-content > div {
overflow: hidden;
}
用于复杂序列的GSAP时间线
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
// 主角区域进入序列
function animateHero() {
const tl = gsap.timeline({ defaults: { ease: 'power2.out' } });
tl.from('.hero-badge', { opacity: 0, y: 16, duration: 0.4 })
.from('.hero-headline', { opacity: 0, y: 20, duration: 0.5 }, '-=0.2')
.from('.hero-subtext', { opacity: 0, y: 16, duration: 0.4 }, '-=0.3')
.from('.hero-cta', { opacity: 0, scale: 0.95, duration: 0.35 }, '-=0.2');
return tl;
}
// 滚动触发的功能卡片
gsap.utils.toArray<HTMLElement>('.feature-card').forEach((card, i) => {
gsap.from(card, {
opacity: 0,
y: 32,
duration: 0.5,
delay: i * 0.08,
ease: 'power2.out',
scrollTrigger: {
trigger: card,
start: 'top 85%',
once: true,
},
});
});
GSAP时间线中的
'-=0.2'偏移量可以在步骤之间创建重叠,形成流畅连贯的序列。如果没有它,每个步骤都感觉脱节。重叠前一步骤持续时间的20-40%。
尊重 prefers-reduced-motion
/* CSS - 作为安全网的通用规则 */
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
// Framer Motion - useReducedMotion 钩子
import { useReducedMotion } from 'framer-motion';
function AnimatedCard({ children }: { children: React.ReactNode }) {
const prefersReduced = useReducedMotion();
return (
<motion.div
initial={prefersReduced ? false : { opacity: 0, y: 12 }}
animate={{ opacity: 1, y: 0 }}
transition={prefersReduced ? { duration: 0 } : { duration: 0.2 }}
>
{children}
</motion.div>
);
}
// 原生JS - 在运行GSAP之前检查偏好
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (!prefersReduced) {
animateHero();
}
反模式
| 错误做法 | 为什么是错误的 | 应该怎么做 |
|---|---|---|
动画化 width、height、top 或 left | 每帧都会触发布局重新计算,导致卡顿 | 改用 transform: scale() 或 transform: translate() |
transition: all | 会捕获意外属性,难以预测,存在性能风险 | 列出具体属性:transition: transform 200ms, opacity 200ms |
| 交互反馈的持续时间超过500ms | 用户感觉UI延迟或损坏 | 保持按钮/悬停/切换在200ms以内,模态框在300ms以内 |
| 对简单的悬停效果使用GSAP | 对于CSS能原生处理的事情,开销巨大 | 状态变化使用CSS transition,仅时间线使用GSAP |
| 总交错延迟超过500ms | 用户等待内容出现,而不是看到它们出现 | 每个项目延迟限制在75ms,总交错限制在400ms |
在所有元素上使用 will-change: transform | 每个 will-change 都会创建一个GPU层 - 过度使用会浪费显存 | 仅添加到你知道会进行动画的元素,动画完成后移除 |
参考资料
有关特定动效主题的详细指导,请阅读 references/ 文件夹中的相关文件:
…
[为翻译而截断]