Motion Craft 是做什么的?
能够沟通而不是装饰的动画。每一帧都必须证明其存在的价值。
灵感来源于 Emil Kowalski(Linear、Sonner、Vaul)、Paul Lewis(Google Chrome)以及 CSS 动画工作组。
工作流程
动画决策框架
在编写任何动画代码之前,按顺序回答以下四个问题。
1. 这个元素是否应该动画?
| 频率 | 决策 | 原因 |
|---|---|---|
| 每天 100+ 次(键盘快捷键、命令面板、搜索切换) | 永远不要动画。 | 动画会让频繁的操作感觉延迟。Raycast 没有打开/关闭动画。最佳选择。 |
| 每天几十次(悬停效果、列表导航) | 移除或大幅减少 | 用户会在重复交互中注意到动画延迟 |
| 偶尔(模态框、抽屉、提示) | 标准动画 | 这是动效的正确使用场景 |
| 少见/首次(引导、确认、庆祝) | 增加惊喜感 | 这些瞬间值得更长时间、更丰富的动画 |
永远不要为键盘触发的操作添加动画。 这些操作每天重复数百次。
2. 动画的目的是什么?
每个动画都必须有一个清晰的答案来解释“为什么这个元素会动?”
| 目的 | 示例 | 有效? |
|---|---|---|
| 空间一致性 | 提示从同一方向进入和退出 | ? |
| 状态指示 | 按钮变形以显示“已发送” | ? |
| 反馈 | 按钮按下时缩小,确认界面收到了用户的输入 | ? |
| 防止突兀变化 | 元素淡入而非突然出现 | ? |
| 解释 | 营销动画展示某个功能的工作原理 | ? |
| “看起来酷”并且用户经常看到它 | 多余的运动 | ? |
3. 应该使用什么缓动?
| 场景 | 缓动 | CSS |
|---|---|---|
| 元素进入 | 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 | cubic-bezier(0.25, 0.1, 0.25, 1) |
| 恒速运动(跑马灯、进度条) | linear | cubic-bezier(0, 0, 1, 1) |
| UI 交互(按钮、工具提示、下拉菜单) | 强 ease-out | cubic-bezier(0.23, 1, 0.32, 1) |
关键:永远不要在 UI 进入动画中使用 ease-in。 一个使用 ease-in 且时长为 300ms 的下拉菜单比同样时长使用 ease-out 的感觉更慢,因为 ease-in 延迟了初始运动——这正是用户最关注的那个瞬间。
4. 动画应该多快?
| 元素 | 时长 | 缓动 |
|---|---|---|
| 按钮按下反馈(缩放) | 100-160ms | cubic-bezier(0.23, 1, 0.32, 1) |
| 工具提示进入/退出 | 125-200ms | cubic-bezier(0.23, 1, 0.32, 1) |
| 下拉菜单/选择/弹出窗 | 150-250ms | cubic-bezier(0.23, 1, 0.32, 1) |
| 悬停变换(缩放、上提) | 200ms | cubic-bezier(0.23, 1, 0.32, 1) |
| 模态框/对话框进入 | 200-300ms | cubic-bezier(0, 0, 0.2, 1) |
| 模态框/对话框退出 | 150-200ms | cubic-bezier(0.4, 0, 1, 1) |
| 抽屉/面板进入 | 200-400ms | cubic-bezier(0.32, 0.72, 0, 1)(类 iOS) |
| 提示进入 | 300-400ms | cubic-bezier(0.23, 1, 0.32, 1) |
| 提示退出 | 200-300ms | cubic-bezier(0.4, 0, 1, 1) |
| 页面过渡 | 300-400ms | cubic-bezier(0.4, 0, 0.2, 1) |
| 滚动揭示(淡入 + 上滑) | 400-800ms | cubic-bezier(0.16, 1, 0.3, 1) |
| 加载闪烁 | 1000-1500ms(无限) | linear |
| 长按删除(按下) | 2000ms | linear(故意缓慢) |
| 长按删除(释放) | 200ms | cubic-bezier(0.23, 1, 0.32, 1)(快速) |
| 营销/解释性 | 800-3000ms | 可变,取决于叙事 |
规则:UI 动画应保持在 300ms 以下。 一个 180ms 的下拉菜单感觉比一个 400ms 的明显更灵敏。
自定义缓动曲线
内置的 CSS ease / ease-in / ease-out 太弱了。使用这些更强的自定义变体:
:root {
--ease-out-strong: cubic-bezier(0.23, 1, 0.32, 1); /* UI 交互,Emil 的签名 */
--ease-in-out-strong: cubic-bezier(0.77, 0, 0.175, 1); /* 屏幕内移动 */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* 类 iOS 抽屉 */
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* 缓慢揭示,戏剧性 */
--ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1); /* 备选强 ease-out */
--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1); /* 轻微过冲,谨慎使用 */
}
来源:easing.dev, easings.co
60fps 黄金规则
每帧 16.67ms。使用 Chrome DevTools 的 Performance 面板验证。仅对 transform 和 opacity 属性进行动画。
| 属性 | GPU 合成? | 触发操作 |
|---|---|---|
transform(平移、缩放、旋转) | ? 是 | 仅合成 |
opacity | ? 是 | 仅合成 |
filter | ?? 有时 | 绘制 + 合成 |
clip-path | ?? 有时 | 绘制 + 合成 |
width, height, top, left, margin, padding, border-width | ? 否 | 布局 + 绘制 + 合成 |
box-shadow | ? 否 | 绘制 + 合成 |
color, background-color | ? 否 | 仅绘制 |
审查格式(必需)
在审查 UI 动画代码时,你必须使用一个包含 Before | After | Why 列的标记表。不要使用包含“Before:”和“After:”的列表,并将它们放在单独的行上。
正确格式:
| Before | After | Why |
|---|---|---|
transition: all 300ms | transition: transform 200ms ease-out | 指定确切属性;避免使用 all,这会触发布局重算 |
transform: scale(0) | transform: scale(0.95); opacity: 0 | 现实世界中没有任何东西是从虚无中出现的 |
下拉菜单使用 ease-in | cubic-bezier(0.23, 1, 0.32, 1) | ease-in 起始缓慢——感觉迟钝。强 ease-out 提供即时反馈 |
按钮没有 :active 状态 | 在 :active 上使用 transform: scale(0.97) | 按钮必须对按压有响应感 |
弹出窗使用 transform-origin: center | transform-origin: var(--radix-popover-content-transform-origin) | 弹出窗应基于其触发器进行缩放。模态框保持居中。 |
transition: 300ms 没有 prefers-reduced-motion | @media (prefers-reduced-motion: reduce) { transition-duration: 0.01ms } | WCAG 2.1 要求支持减少运动 |
在 Framer Motion 中使用 animate={{ x: 100 }} | animate={{ transform: "translateX(100px)" }} | Framer Motion 的 x/y 并非硬件加速。使用 transform 字符串以获得 GPU 加速。 |
错误格式(永远不要这样做):
Before: transition: all 300ms
After: transition: transform 200ms ease-out
CSS 过渡(UI 首选)
CSS 过渡是可中断的——它们可以在动画中途重新定向。关键帧会从头重新启动。对于任何可能被快速触发的交互(提示、切换、下拉菜单),过渡能产生更平滑的效果。
.button {
transition: transform 160ms ease-out;
}
.button:active {
transform: scale(0.97);
}
.tooltip {
transition: transform 125ms ease-out, opacity 125ms ease-out;
transform-origin: var(--transform-origin);
}
非对称进入/退出时序
进入可以慢些(用户在决定),退出必须快(系统在响应):
.overlay {
transition: clip-path 200ms ease-out; /* 释放:快 */
}
.button:active .overlay {
transition: clip-path 2s linear; /* 按压:慢且刻意 */
}
工具提示:在后续悬停时跳过延迟
.tooltip {
transition: transform 125ms ease-out, opacity 125ms ease-out;
transform-origin: var(--transform-origin);
}
.tooltip[data-instant] {
transition-duration: 0ms;
}
使用 @starting-style 的进入状态(截至 2026 年仅 Chrome 支持,尚未成为基线)
.toast {
opacity: 1;
transform: translateY(0);
transition: opacity 400ms ease-out, transform 400ms ease-out;
@starting-style {
opacity: 0;
transform: translateY(100%);
}
}
注意:
@starting-style和滚动驱动动画(animation-timeline: view(),animation-timeline: scroll())截至 2026 年仍仅限 Chrome。对跨浏览器支持,请使用 JavaScript 回退方案。
长按删除模式
.overlay {
clip-path: inset(0 100% 0 0);
transition: clip-path 200ms ease-out; /* 释放:快 */
}
.button:active .overlay {
clip-path: inset(0 0 0 0);
transition: clip-path 2s linear; /* 按压:慢且刻意 */
}
按钮 - 触觉反馈
每个可按压元素都需要物理响应。
.button {
transition: transform 160ms cubic-bezier(0.23, 1, 0.32, 1);
}
.button:active {
transform: scale(0.97);
}
缩放必须微妙(0.95-0.98)。适用于所有可按压元素——按钮、卡片、列表项、标签。
弹出窗 - 原点感知
弹出窗从它的触发器缩放,而不是中心。模态框保持居中。
/* Radix UI */
.popover {
transform-origin: var(--radix-popover-content-transform-origin);
}
/* Base UI */
.popover {
transform-origin: var(--transform-origin);
}
/* 模态框(始终居中) */
.modal {
transform-origin: center;
}
无论用户是否注意到,这都无关紧要。总之,看不见的细节会叠加。
交错动画
当多个元素一起进入时,交错显示它们。
.item {
opacity: 0;
transform: translateY(8px);
animation: fadeIn 300ms ease-out forwards;
}
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
.item:nth-child(4) { animation-delay: 150ms; }
@keyframes fadeIn {
to {
opacity: 1;
transform: translateY(0);
}
}
保持交错延迟短(项目之间 30-80ms)。绝不要让交互在交错动画播放期间被阻塞。
CSS 动画(关键帧)
用于预定的、非动态的动画。关键帧在中断时会从头重新启动——避免在 UI 中使用。
@keyframes enter-right {
from { opacity: 0; transform: translateX(16px); }
to { opacity: 1; transform: translateX(0); }
}
.enter {
animation: enter-right 300ms ease-out forwards;
}
弹簧动画
弹簧比基于时长的动画感觉更自然,因为它们模拟了真实物理。它们在中途中断时能保持速度。
何时使用弹簧
- 带有动量的拖拽交互
- 感觉“有生命”的元素(Apple 灵动岛风格)
- 可以在动画中途中断的手势
- 装饰性的鼠标追踪交互
Apple 方法(推荐 - 更容易推理)
{ type: "spring", duration: 0.5, bounce: 0.2 }
传统物理方法(更多控制)
{ type: "spring", stiffness: 100, damping: 10, mass: 1 }
保持弹跳轻微(0.1-0.3)。在大多数 UI 中避免弹跳。仅用于拖拽消除和有趣的交互。
基于弹簧的鼠标交互
import { useSpring } from 'framer-motion'
const springX = useSpring(mouseX * 0.1, { stiffness: 100, damping: 10 })
没有弹簧:感觉不自然,瞬时。有弹簧:感觉自然,有动力。
WEB 动画 API (WAAPI)
编程式 CSS 动画。硬件加速、可中断、无需库。
const element = document.querySelector('.card')
const animation = element.animate([
{ transform: 'scale(1)', opacity: 1 },
{ transform: 'scale(0.95)', opacity: 0.7 },
], {
duration: 200,
easing: 'cubic-bezier(0.23, 1, 0.32, 1)',
fill: 'both',
})
animation.pause()
animation.play()
animation.reverse()
animation.finish()
animation.finished.then(() => console.log('done'))
在高负载下,WAAPI 胜过 Framer Motion——它在主线程之外运行。用于动态、可中断的动画,当 CSS 关键帧无法满足时。
滚动驱动动画
浏览器支持说明: 滚动驱动动画(animation-timeline: view() 和 scroll())截至 2026 年仍仅限 Chrome/Edge,尚未成为基线。请通过 IntersectionObserver 为 Firefox/Safari 提供 JS 回退方案。
ViewTimeline(元素进入/离开视口)
@keyframes fade-up {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
.reveal {
animation: fade-up 600ms linear both;
animation-timeline: view();
animation-range: entry 0% entry 100%;
}
ScrollTimeline(页面滚动位置)
@keyframes shrink {
from { height: 80px; }
to { height: 50px; }
}
.site-header {
animation: shrink 300ms linear both;
animation-timeline: scroll();
animation-range: 0 200px;
}
滚动联动视差(原生 JS)
const layers = document.querySelectorAll('[data-parallax]')
window.addEventListener('scroll', () => {
const scrollY = window.scrollY
layers.forEach(layer => {
const speed = parseFloat(layer.dataset.parallax) || 0.3
layer.style.transform = `translateY(${scrollY * speed}px)`
})
})
FLIP 技术
用于布局动画——对改变位置/大小的元素进行动画。
function animateLayout(element, callback) {
const first = element.getBoundingClientRect()
callback()
const last = element.getBoundingClientRect()
const dx = first.left - last.left
const dy = first.top - last.top
const dw = first.width / last.width
const dh = first.height / last.height
element.animate([
{ transform: `translate(${dx}px, ${dy}px) scale(${dw}, ${dh})` },
{ transform: 'translate(0, 0) scale(1, 1)' },
], {
duration: 300,
easing: 'cubic-bezier(0.4, 0, 0.2, 1)',
})
}
剪切路径动画(CLIP-PATH)
CSS 中最强大的动画工具之一。硬件加速。
.overlay {
clip-path: inset(0 100% 0 0);
transition: clip-path 200ms ease-out;
}
.visible {
clip-path: inset(0 0 0 0);
}
用于:长按删除、滚动时图像揭示、比较滑块、标签页的无缝颜色过渡。
感知性能
动画的速度直接影响…