Figma 原型动效参数与前端代码工程化交付实战:Custom Bezier 换算、Spring 物理弹簧映射 CSS / Framer Motion / GSAP 与掉帧避坑
在日常的产研协作中,静态界面的尺寸、色值与间距已经可以通过 Dev Mode 开发模式 精确复制,但一到交互动效交付环节,设计师与前端或客户端工程师之间往往立刻退回到“玄学沟通”:设计师在 Figma 原型设计 中精心调校了弹性抽屉与弹窗缓动,研发在代码里却看不到直接可粘贴的动画参数,只能录屏对照肉眼估摸时长与曲线;或者直接把 Figma 物理弹簧面板里的 Damping 数值原封不动抄进 Android Jetpack Compose,结果上线后弹窗几乎弹不动甚至反复鬼畜抖动。
要彻底消灭动效交付偏差,关键在于厘清 Figma Prototype 面板中 Bezier 曲线 与 Spring 物理弹簧 的底层数学模型,并掌握它们向 Web CSS、Framer Motion、GSAP 以及移动端原生框架的标准化转换口径。若你在制作原型过程中频繁遇到 Smart Animate 转场失灵或元素闪烁,可同步参阅 Figma 智能动画(Smart Animate)深水区避坑实战。
一、Figma 缓动模型与各端动画引擎映射全景表 #
在打开原型连线面板之前,产研双方需先对 Figma 原生动画曲线与目标技术栈的映射关系达成共识:
| Figma Prototype 曲线类型 | 数学本质与参数结构 | Web CSS 原生对应写法 | React Framer Motion / GSAP | iOS SwiftUI / Android Compose |
|---|---|---|---|---|
| Linear | 匀速线性插值 + 固定时长(ms) | transition-timing-function: linear | ease: "linear" / ease: "none" | .linear / LinearEasing |
| Ease In / Out / In and Out | 预设三次贝塞尔曲线 + 时长 | 近似 cubic-bezier(...)(注意各端默认曲线与 Figma 略不同,建议读具体控制点) | 传入具体 4 位坐标 [x1, y1, x2, y2] | Animation.timingCurve(x1, y1, x2, y2) / CubicBezierEasing(...) |
| Custom Bezier | 4 个控制点坐标 (x1, y1, x2, y2) + 时长(ms) | cubic-bezier(x1, y1, x2, y2)(支持 y < 0 或 y > 1 超调) | ease: [x1, y1, x2, y2] / CustomEase | 直接传 4 个浮点控制点坐标 |
| Gentle / Quick / Bouncy / Slow | 内置物理弹簧预设(本质为固定一组 Stiffness / Damping / Mass) | 原生 CSS cubic-bezier 无法模拟弹簧回弹,需改用 CSS linear() 采样函数 | 转为 type: "spring" 并填入对应物理三参数 | SwiftUI .interpolatingSpring;Compose 需换算 dampingRatio |
| Custom Spring | 物理三参数:Stiffness(刚度)、Damping(阻尼)、Mass(质量) | CSS linear(...) 多点插值近似,或交由 JS 动画库接管 | Framer Motion 原生同源:直接传入 stiffness、damping、mass | Compose 必须将阻尼系数换算为阻尼比 $\zeta$,严禁直接照抄数字 |
二、实操一:Custom Bezier 贝塞尔曲线读取与 CSS / GSAP 转换 #
当使用非弹性交互(例如侧边栏滑入、遮罩淡入、数值进度条推进)时,建议在原型面板明确使用 Custom Bezier 而非笼统的 Ease out 预设名称,因为浏览器内置 ease-out 关键字对应 (0, 0, 0.58, 1),与 Figma 原生 Ease Out 预设曲线并不完全一致。
1. 读取四位控制点坐标与时长 #
- 切换到右侧 Prototype 面板,点击画板或组件之间的交互连线,打开 Interaction details 弹窗;
- 将 Animation 下拉框切换为
Smart Animate(或Move in/Push),在曲线选择框中选择Custom Bezier; - 鼠标悬停或点击曲线图下方的控制点输入框,即可看到 4 个浮点数(例如
0.22, 1, 0.36, 1)以及右侧的毫秒时长(例如320ms)。
2. 直接输出生产级 CSS 与 GSAP 代码 #
- Web CSS Transitions / Keyframes:将 Figma 的
ms换算为s(或直接写320ms),控制点原样填入cubic-bezier():/* Figma Custom Bezier (0.22, 1, 0.36, 1), 320ms */ .drawer-panel { transition: transform 320ms cubic-bezier(0.22, 1, 0.36, 1), opacity 240ms cubic-bezier(0.22, 1, 0.36, 1); } - 超调(Overshoot)边界检查:在 Figma 曲线编辑器中把右上角手柄向上拉出盒子边界时,
y2会大于1(例如0.34, 1.56, 0.64, 1)。CSScubic-bezier()完全合法支持y超出[0, 1]来做出轻微回弹,但横向时间轴坐标x1与x2必须严格落在0到1之间,否则浏览器会整行丢弃该声明。 - GSAP 对接写法:GSAP 默认核心不直接吃 4 位坐标,需引入官方
CustomEase插件或使用原生支持数组缓动的 Web Animations API:element.animate( [{ transform: 'translateY(16px)', opacity: 0 }, { transform: 'translateY(0)', opacity: 1 }], { duration: 320, easing: 'cubic-bezier(0.22, 1, 0.36, 1)', fill: 'forwards' } );
三、实操二:Spring 物理弹簧参数映射 Framer Motion、Compose 与 CSS #
物理弹簧(Spring)没有固定的“截止时间”,动作持续多久由刚度(Stiffness $k$)、**阻尼(Damping $c$)和质量(Mass $m$)**共同决定。设计师在原型里选择 Gentle / Quick / Bouncy / Slow 时,只要在下拉框旁切换到 Custom spring,Figma 就会把当前预设背后的实时三参数直接暴露出来:
| Figma Spring 预设 | Stiffness(刚度 $k$) | Damping(阻尼 $c$) | Mass(质量 $m$) | 适用界面动效场景 |
|---|---|---|---|---|
| Gentle | 100 | 15 | 1 | 大型抽屉展开、页面级容器柔和过渡 |
| Quick | 300 | 20 | 1 | 按钮按压反馈、标签页指示条滑动、轻提示弹出 |
| Bouncy | 600 | 15 | 1 | 徽标气泡弹跳、点赞/收藏强情绪微交互 |
| Slow | 80 | 20 | 1 | 长距离视口过渡、背景渐变柔和切换 |
1. 对接 React Framer Motion(1:1 同源直传) #
Framer Motion 的底层物理模型与 Figma 完全一致,研发无需额外换算即可直接复用三参数:
// 对应 Figma Quick 弹簧预设
<motion.div
initial={{ scale: 0.94, opacity: 0 }}
animate={{ scale: 1, opacity: 1 }}
transition={{ type: "spring", stiffness: 300, damping: 20, mass: 1 }}
/>
2. 对接 Android Jetpack Compose(警惕阻尼比换算坑) #
这是全链路中最容易翻车的一步:Figma 里的 Damping 是绝对阻尼系数 $c$,而 Jetpack Compose 的 spring(dampingRatio, stiffness) 要求传入无量纲的阻尼比 $\zeta$!如果把 Figma 的 Damping = 20 直接填给 dampingRatio,系统会按 20 倍过阻尼计算,动画会慢到像冻住一样。
换算公式如下(在设计标注中建议帮客户端研发直接算好): $$\zeta = \frac{c}{2 \sqrt{m \cdot k}}$$
以 Figma Quick($k = 300, c = 20, m = 1$) 为例:
$$\zeta = \frac{20}{2 \times \sqrt{1 \times 300}} \approx \frac{20}{34.64} \approx 0.577$$
// Jetpack Compose 正确还原 Figma Quick 弹簧
animateFloatAsState(
targetValue = 1f,
animationSpec = spring(
dampingRatio = 0.577f, // 对应 Damping=20 的阻尼比,而非直接填 20f
stiffness = 300f
)
)
3. 纯 CSS 零 JS 弹簧近似(linear() 函数) #
对于追求零包体积的静态官网或普通组件库,现代浏览器(Chrome 113+ / Safari 17.2+ / Firefox 112+)已全面支持 CSS linear() 多点采样函数,可将弹簧曲线离散为带回弹的原生 CSS 声明(如模拟轻量弹跳):
.toast-enter {
transition: transform 480ms linear(
0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%,
1.017, 1.077, 1.102, 1.105 25%, 1.093, 1.066 29.5%,
1.007 35.6%, 0.985, 0.976 41.3%, 0.977, 0.996 52.3%, 1.003 59%, 1
);
}
四、Dev Mode 动效交付规范与 Smart Animate 掉帧排查清单 #
1. 在 Dev Mode Annotations 中建立标准化动效卡片 #
因为原生 Dev Mode 侧边面板聚焦静态布局样式,研发并不会主动切回 Prototype 模式逐条翻连线。建议在完成交互设计后,切入 Dev Mode(Shift + D) 并按 Y 键使用 原生 Annotations 开发标注,为关键交互容器挂载结构化动效卡片:
- Trigger(触发时机):如
Click / Hover / State = Open; - Properties(变动属性):明确写
translateY(16px -> 0)、opacity(0 -> 1); - Curve & Params(曲线与参数):直接写出
Spring(stiffness: 300, damping: 20, mass: 1) / Compose dampingRatio: 0.58或cubic-bezier(0.22, 1, 0.36, 1) · 320ms。
2. 常见动效掉帧与还原异常排查清单 #
- Smart Animate 里改了容器
Width/Height,网页照抄后掉帧严重:- 原因:Figma 画板间直接改变容器宽高或
Padding,前端若直接对width/height做过渡,每帧都会触发浏览器 Layout(重排)与 Paint(重绘)。 - 解法:在动效标注中明确要求前端改为固定最终尺寸 +
transform: scale()配合overflow: hidden或位移实现,严禁对width/height/top/left/box-shadow做高频逐帧动画。
- 原因:Figma 画板间直接改变容器宽高或
- Figma 预览一切丝滑,Dev Mode 交付后组件弹窗阴影出现“骤变闪烁”:
- 原因:同时改变多层
Drop Shadow扩散半径在浏览器端开销极大且跨帧插值容易生硬。 - 解法:将投影独立置于底层容器上,过渡时仅改变阴影层的
opacity: 0 -> 1,可满帧跑在 GPU 合成线程上。
- 原因:同时改变多层
- Interactive Components 内部状态切换时弹簧动画没触发:
- 原因:变体内部子图层名称未保持完全一致,或交互连线误选了
Instant而非Smart Animate;对于跨分支复用状态机,参考 原型状态管理实战 检查是否意外开启了Reset component state。
- 原因:变体内部子图层名称未保持完全一致,或交互连线误选了
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。