CSS动画方向animation-direction_实现往返运动与交替播放

animation-direction: alternate 未生效是因为缺少 animation-iteration-count（如 infinite），它仅定义每次迭代方向，不控制循环次数；需配合多次迭代才能体现往返效果。

animation-direction: alternate 为什么没生效

常见现象是加了 animation-direction: alternate，但动画只正向跑一遍就停了，根本没“往返”。根本原因：缺了循环控制——animation-direction 本身不控制播放次数，它只定义「每次迭代」的方向，必须配合 animation-iteration-count（比如设为 infinite 或大于 1 的数）才看得到交替效果。

使用场景多见于按钮悬停反馈、加载指示器、图标呼吸动效。注意：如果 animation-iteration-count: 1，那 alternate 完全没意义，第二遍都不播，何来“换方向”？

• animation-direction: alternate + animation-iteration-count: 2 → 第1次正向，第2次反向
• animation-direction: alternate-reverse 是反向起手的交替，即第1次反向，第2次正向
• IE10+ 支持 alternate，但 IE 不支持 alternate-reverse（别在兼容老项目里用）

animation-direction 与 animation-play-state 的交互陷阱

暂停动画再恢复时，animation-direction 不会“重置方向计数”。比如一个 infinite + alternate 动画播到第3次（正向），暂停后恢复，它会继续第3次正向播完，然后才切到第4次反向——不是从头开始交替。

这意味着：你不能靠暂停/恢复来“强制切方向”。如果真需要手动控制往返节奏（比如点击一次前进一帧、再点一次后退），得放弃纯 css 动画，改用 transform + js 控制 style.transform，或用 @keyframes 拆成两个独立动画手动切换。

立即学习“前端免费学习笔记（深入）”；

• 浏览器不会把暂停态记为一次“完整迭代”，所以方向切换时机完全由已播放的 iteration 次数决定
• animation-play-state: paused 期间，animation-direction 值仍有效，但不执行
• 用 getComputedStyle(el).animationDirection 查不到运行时方向，只能读声明值

alternate 和 keyframes 里的 from/to 顺序强相关

animation-direction: alternate 的“反向”不是镜像翻转，而是按 keyframes 中定义的帧顺序倒着播。也就是说，反向播放时，from 变成终点，to 变成起点；如果你 keyframes 写的是 from { opacity: 0 } → to { opacity: 1 }，那反向就是从 1 变回 0。

容易踩的坑：有人以为 alternate 能让动画“自动适配”起止状态，结果发现反向第一帧卡顿或跳变——其实是 keyframes 里中间帧没对称写好。例如：

@keyframes slide {   0% { transform: translateX(0); }   50% { transform: translateX(100px); }   100% { transform: translateX(0); } }

这个动画正向是“0→100→0”，反向就是“0→100→0”倒播，看起来一样；但如果删掉 50%，只留 0% 和 100%，反向就只是线性来回，无中间缓冲。

• 反向播放不改变 keyframes 的数值计算逻辑，只改变时间轴采样顺序
• 想让往返都带缓动，别只依赖 animation-timing-function，要在 keyframes 里显式写出对称关键帧
• 用 animation-timing-function: ease-in-out 配合 alternate，效果常不如直接在 keyframes 里用 cubic-bezier() 精控

用 JavaScript 动态切换 animation-direction 的实际限制

能写，但别指望它实时“掰正”正在播的动画。给元素动态设置 style.animationDirection = 'reverse'，浏览器会等当前 iteration 结束后，才在下一次迭代应用新方向——不是立即反转运动。

真正需要帧级方向干预（比如拖拽中实时反向），得放弃 animation-direction，改用 requestAnimationFrame 手动更新 transform 或 opacity。CSS 动画的方向控制是声明式的、面向整个动画周期的，不是命令式的、面向单帧的。

• dom 属性修改触发的是样式重计算，不是动画重调度
• 用 el.getAnimations() 可以拿到当前动画实例，但它没有 reverse() 方法（chrome 115+ 有 reverse()，但仅限 Web Animations API，不适用于 CSS animation 声明）
• 服务端渲染或 SSR 场景下，初始 animation-direction 值若靠 JS 注入，可能闪一下默认方向

事情说清了就结束。animation-direction 的复杂点不在语法，而在它和 iteration、timing、keyframes 三者的耦合关系——方向不是孤立属性，它是动画生命周期里的一个状态指针。