用 $anim-seq 这类 map 变量统一管理动画时序参数,关键帧与选择器均通过 map-get() 读取,配合分离的 animation 属性写法,确保修改一处、全局同步,避免错位与覆盖。

动画序列变量在 Sass 中怎么定义才不会和 CSS 动画时序对不上
直接说结论:用 $animation-timings 这类命名的 map 变量统一存时长/延迟/贝塞尔曲线,别用独立变量拼接。否则改一个时长,animation 复合属性里漏同步,动画就错位。
常见错误是这样写:
$fade-duration: 0.3s;<br>$fade-delay: 0.1s;<br>.box { animation: fade-in $fade-duration ease-out $fade-delay; }
问题在于:fade-in 关键帧本身可能也依赖时长(比如控制 opacity 渐变节奏),而关键帧里没引用变量——结果变量改了,关键帧没动,视觉节奏就崩了。
正确做法是把时序逻辑收拢到一个 map 里,关键帧用 map-get() 拉取:
$anim-seq: (<br> "fade": (duration: 0.3s, delay: 0.1s, easing: ease-out),<br> "slide": (duration: 0.4s, delay: 0.2s, easing: cubic-bezier(0.2, 0.8, 0.4, 1))<br>);<br><br>@keyframes fade-in {<br> 0% { opacity: 0; }<br> 100% { opacity: 1; }<br>}<br><br>.box {<br> $fade: map-get($anim-seq, "fade");<br> animation: fade-in map-get($fade, duration) map-get($fade, easing) map-get($fade, delay);<br>}
- 所有时序参数必须成组管理,避免「改了 duration 忘了调 keyframes」
- map 键名(如
"fade")要和关键帧名保持一致,降低维护成本 - 别在
@keyframes里硬编码数值——Sass 不支持在 keyframes 作用域内调用map-get()
为什么用 animation-name + animation-delay 分离写比复合 animation 属性更可控
因为复合 animation 属性会强制覆盖整个动画声明,只要其中一项变化(比如只改 delay),其他项(duration/easing)若没显式写出,就会回退到初始值(通常是 0s 或 ease),导致意外中断或跳帧。
典型翻车场景:组件复用同一套动画变量,但某个实例只想微调延迟,于是写:
.card:hover { animation: slide-up 0.2s; } /* 漏写了 delay 和 easing */
结果原本该有的 0.1s delay 和 cubic-bezier(...) 全丢了。
分离写法能明确控制每个维度:
.card {<br> animation-name: slide-up;<br> animation-duration: map-get(map-get($anim-seq, "slide"), duration);<br> animation-timing-function: map-get(map-get($anim-seq, "slide"), easing);<br> animation-delay: map-get(map-get($anim-seq, "slide"), delay);<br>}<br><br>.card:hover { animation-delay: 0.05s; } /* 只动 delay,其余不动 */
- 分离写法让局部覆盖更安全,hover、focus 等状态只需改一两个属性
- 浏览器解析
animation复合属性时,未指定项按规范重置,不是继承上一个声明 - Sass 编译后 CSS 体积略增,但可维护性提升远大于这点开销
调试时如何快速定位是 Sass 变量没生效,还是 CSS 动画本身卡住了
先看 DevTools 的 Computed 面板里 animation-name 和 animation-duration 是否显示为预期值。如果显示的是原始变量名(比如 $fade-duration),说明 Sass 根本没编译成功——那是编译层问题;如果显示的是数值(如 0.3s)但动画不动,才是运行时问题。
常见混淆点:
-
animation-play-state: paused被误设为默认值,动画根本没启动 - 关键帧里用了
transform: translateX(100px),但元素父容器overflow: hidden且没预留空间,位移被裁掉,看起来像“卡住” - Sass 中变量写成
$duration: 300ms,但关键帧里写100% { opacity: 1; transition: $duration; }——transition不是animation,压根不触发
最简验证法:临时把关键帧内容改成 0% { background: red; } 100% { background: blue; },绕过 transform / opacity 等易被遮挡的属性,纯看颜色是否切换。
多个动画串联时,animation-delay 怎么算才不靠试数
别手动加总。用 Sass 函数累加前序动画的 duration + delay,再减去重叠部分(如果有 animation-fill-mode: forwards 且下一动画想无缝衔接)。
例如:淡入(0.3s)→ 滑入(0.4s),要求滑入在淡入结束瞬间开始:
$fade: map-get($anim-seq, "fade");<br>$slide: map-get($anim-seq, "slide");<br><br>.seq-1 {<br> animation-name: fade-in;<br> animation-duration: map-get($fade, duration);<br> animation-delay: map-get($fade, delay);<br>}<br><br>.seq-2 {<br> animation-name: slide-in;<br> animation-duration: map-get($slide, duration);<br> // 下一动画 delay = 前一个的总耗时(duration + delay)<br> animation-delay: map-get($fade, duration) + map-get($fade, delay);<br>}
- 如果中间有等待空档,比如淡入完停 0.2s 再滑入,就在 delay 后额外加
+ 0.2s - 注意
animation-fill-mode: forwards不影响 delay 计算,它只控制动画结束后样式保持,不改变触发时机 - 千万别用
setTimeout在 JS 里控制 class 切换做串联——CSS 动画时序精度远高于 JS 定时器,尤其在低性能设备上
真正麻烦的不是计算,是当某段动画 duration 改了,所有后续的 animation-delay 都得跟着重算。所以必须把依赖关系写死在变量 map 和函数里,而不是散落在各处 CSS 规则中。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











