基于原子 CSS 的图标动效方案
- 2026.05.31
一套图标动效方案,包括一个纯 CSS 的动效工具库、一个供设计师制作动效的编辑器,以及一个可批量生成动效的 Skill。它用于腾讯云官网与控制台侧边栏,让设计师和 AI 用同一套动效词汇制作上千个图标。
背景
2026 年腾讯云进行平台视觉焕新,范围包括控制台首页与控制台框架。框架的主体是左侧导航栏,焕新内容之一是重绘导航图标,并为图标增加鼠标悬停时的动效。
导航栏覆盖约 200 个云产品,共有 2000 多个图标。若使用 After Effects、Lottie 或 Rive 逐个制作,每个图标都需要单独设计和导出,成本高,多人制作时也难以保证节奏和幅度一致。
因此,方案需要同时满足三个条件:能够由 AI 批量生成;所有图标遵守同一套约束;设计师能够逐个检查和调整。AI 可以参与生成,但前提是有一套稳定的动效系统供它使用。
技术方案
我比较了三种常见的图标动效载体:
| 方案 | 优点 | 缺点 |
|---|---|---|
| GIF | 兼容性好,所见即所得 | 文件大、分辨率固定、难以适配深色模式、无法由交互控制播放 |
| Lottie | 表现力强,支持复杂路径动画 | 每个图标需要一份 JSON 和约 60KB 的播放器,AI 难以直接生成和修改 |
| CSS | 矢量无损、体积小、无需 JS 播放器、颜色跟随 | 难以表达复杂的路径变形 |
Lottie 的表现力最强,但导航图标的动效通常只需要位移、缩放、旋转、淡入淡出和描边,CSS 足以覆盖。GIF 无法跟随深色模式改变颜色,在高分屏上也容易模糊。CSS 动画直接写在 SVG 上,图标颜色仍由 currentColor 继承,也是 AI 最熟悉的格式之一,因此我选择了 CSS。
动效词汇
原子化
选定 CSS 后,数量问题仍然存在。为 2000 个图标逐个编写关键帧(@keyframes),工作量并没有减少,AI 每次从零生成也难以保持一致。
Tailwind CSS 提供了另一种思路。它把样式拆成 p-4、text-sm 这类小单元,界面由这些单元组合而成。动效也可以这样拆分:把“从 75% 放大到原尺寸”“旋转 12° 再回来”分别定义为一个类名,图标的动效由几个类名组合而成。对设计师而言,一个类名相当于一条动画属性;对 AI 而言,从有限的词汇中选择组合,比从零编写关键帧稳定得多。
我以开源库 tailwindcss-motion 为起点。它已有完整的动效分类和预设值,但基于 Tailwind v3 的 JS 插件架构,不能直接用于 Tailwind v4。我使用 Claude Code 将它改写为 Tailwind v4 的 @utility 与 CSS 变量实现,并针对 SVG 图标做了裁剪和扩展。改写后的库命名为 tailwindcss-icon-motion。
类名规则
每个类名由类型、阶段和数值三部分组成:motion-{类型}-{阶段}-{值}。以铃铛为例:
<svg data-motion-icon viewBox="0 0 24 24" fill="none" stroke="currentColor">
<path class="motion-shake-loop-12 origin-top" d="…" />
<path class="motion-draw-in-100 motion-delay-75" pathLength="1" d="…" />
</svg>
第一个类名表示铃身以顶部为轴摇晃 12°;第二个表示铃舌的线条从无到有描绘出来,延迟 75ms 开始。三个阶段的含义如下:
in(入场):从给定值回到元素的原始状态,播放一次。out(出场):从原始状态变化到给定值,播放一次。loop(往返):从原始状态到给定值再回来,默认播放一次,需要时可设为无限循环。
类名前加 - 表示反方向,例如 -motion-draw-in-100 从路径另一端开始描绘。支持的动效如下:
| 动效 | 入场 | 出场 | 往返 | 说明 |
|---|---|---|---|---|
| 位移 | 从上下左右移入 | 向上下左右移出 | 上下左右浮动 | 支持反向 |
| 缩放 | 从小到大出现 | 从大到小消失 | 心跳、呼吸效果 | 支持单轴缩放 |
| 旋转 | 旋转进入 | 旋转退出 | 来回转动 | 支持反向 |
| 摇晃 | 晃入 | 晃出 | 阻尼摆动 | 支持反向 |
| 淡入淡出 | 渐显 | 渐隐 | 闪烁 | — |
| 描边 | 线条描绘进入 | 线条擦除 | 线条往返 | 支持反向 |
时长、延迟、循环次数、缓动曲线和变换原点也是类名,追加在同一个 class 里。缓动曲线共 22 种,包括标准曲线、回弹、弹簧和弹跳。预设值不够时,可以写任意值,如 motion-rotate-in-[30deg]。
组合
类名组合起来不能互相覆盖,这是原子化需要解决的核心技术问题。
在 CSS 中,一个元素同时播放两个动画需要写在同一条 animation 声明里:
.element {
animation:
scale-in 0.3s,
rotate-in 0.3s;
}
如果把两个动画拆成两个类名,后一个类名的 animation 会整体替换前一个,最终只有一个动画生效。
tailwindcss-motion 的解决方法是动画槽位,我沿用了这一设计。所有类名共享同一条 animation 声明,其中为每种属性、每个阶段预留一个位置,默认值为 none。每个类名只向自己的位置写入动画,其他位置保持不变:
@utility motion-translate-x-in-* {
--motion-translate-in-animation: motion-translate-in 300ms ease both;
animation:
var(--motion-scale-in-animation), var(--motion-translate-in-animation),
var(--motion-rotate-in-animation), /* …其余各属性、各阶段的槽位,未使用时为 none */;
}
每个阶段有缩放、位移、旋转、透明度、描边五个槽位。因此 motion-scale-in-75 motion-translate-x-loop-25 可以同时生效。摇晃与旋转共用一个槽位,同一元素只能二选一。
往返阶段的槽位设置了 animation-composition: accumulate,在入场动画的结果上叠加。元素可以先移入,再从当前位置继续浮动。
针对图标的调整
tailwindcss-motion 面向通用网页元素。为适配 SVG 图标,我做了以下调整:
- 新增描边动画。通过
stroke-dashoffset实现线条描绘,要求路径设置pathLength="1",把任意长度的路径统一为 1。stroke-dasharray设为1.1而不是1,起点偏移0.05,因为数值恰好等于路径长度时,浏览器的亚像素渲染可能在端点处产生闪烁。 - 新增摇晃动画。关键帧内置逐级衰减的摆动,振幅依次为原值的 -0.5、0.25、-0.1 倍,接近铃铛或挂件的阻尼摆动。
- 修正 SVG 的变换原点。SVG 内部元素默认以画布左上角为轴旋转和缩放,HTML 元素则以自身中心为轴。在
<svg>上标记data-motion-icon后,内部元素统一以自身中心为轴;齿轮、风扇等径向对称的图标可改用motion-origin-viewbox,以画布中心为轴。 - 移除了 30 多个预设组合(如
motion-preset-fade)。组合由 AI 根据图标语义完成,预设反而会限制选择。同时移除了滤镜、文字颜色和背景色动画,图标动效用不到。 - 默认时长从 700ms 缩短为 300ms,适合悬停这类微交互;往返动画默认播放一次,而不是无限循环,因为导航图标的动效在悬停后完成即可。
- 补充了基于
linear()的弹簧缓动,曲线来自 kvin.me/css-springs。 - 所有关键帧都包裹在
@media (prefers-reduced-motion: no-preference)中,用户在系统中开启“减弱动态效果”后,动画不会执行。
触发方式
动效默认在图标出现时播放一次。导航栏需要的是交互时播放,因此需要触发机制。我的原则是能用 CSS 完成的部分不使用 JS:动画的暂停与播放由浏览器处理,不触发 React 重新渲染,2000 多个图标同时存在时也没有额外的运行时开销。
在容器上设置 data-motion-trigger,容器内的动画在触发前被 animation-name: none !important 完全抑制。目前支持三种触发:
| 触发 | 播放时机 | 复位时机 | 是否需要 JS |
|---|---|---|---|
hover | 指针悬停在容器 | 指针离开 | 否 |
state | 容器处于开启态 | 容器关闭 | 否 |
click | 每次点击 | 停在末帧 | 是 |
hover 用于导航项:触发器放在整个列表项上,悬停列表项的任意位置都会播放其中的图标。
state 用于侧边栏开关、菜单、收藏按钮等有开关状态的控件。“开启”的判断依据是组件为无障碍本已设置的属性,如 aria-expanded="true"、aria-pressed="true",或 Radix 等组件库设置的 data-state="open"。开发者不需要为动效额外编写状态逻辑。
click 是唯一需要 JS 的触发,因为 CSS 无法在每次点击时让动画从头播放。为此我写了一个约 60 行的脚本,在 document 上监听点击,找到被点击的容器后重新播放其中的图标动画。它不依赖任何框架,后续动态加入的元素同样生效。
有开关状态的控件还需要两个播放修饰:
motion-hold-start:触发前,入场动画停在第一帧。例如侧边栏图标中表示面板的矩形,在关闭态保持收起。motion-leave-reverse:触发结束时,从当前帧平滑倒放回去,而不是跳回原状。关键帧动画在中途被取消时无法倒放,因此这个修饰把关键帧动画替换为 CSS 过渡(transition),由浏览器从当前位置插值返回。
<button data-motion-trigger="state" aria-expanded="false">
<svg data-motion-icon viewBox="0 0 24 24" fill="none" stroke="currentColor">
<rect class="motion-scale-x-in-0 origin-left motion-hold-start motion-leave-reverse" … />
<rect x="3" y="3" width="18" height="18" rx="2" />
<path d="M9 3v18" />
<path class="motion-rotate-in-180 motion-hold-start motion-leave-reverse" d="m16 15-3-3 3-3" />
</svg>
</button>
这个侧边栏开关在展开时,面板从左侧展开、箭头翻转 180°;收起时两者沿原路返回。
制作流程
动效词汇确定后,剩下的问题是让设计师高效地使用它。我提供了两个入口,二者使用同一套类名:编辑器 Studio 适合逐个精调,Skill 适合批量生成。
Studio
Studio 是一个浏览器中的编辑器,界面布局参照 Figma:左侧是图层,中间是画布,右侧是属性。
- 导入 SVG。SVGO 自动清理冗余节点,并为路径添加
pathLength="1",使其可以使用描边动画。 - 分组。动效通常作用于图标的语义部件,而不是单条路径。设计师可以拖拽分组,也可以让 AI 结合 SVG 源码和渲染图给出建议,例如把齿轮分为“外圈齿牙”和“中心圆孔”。
- 设置动效。为每组添加一条或多条动画,选择类型、阶段、数值、方向、延迟、循环次数和变换原点;时长和缓动可统一设置。
motion-hold-start与motion-leave-reverse在面板中显示为“初始状态”和“触发结束时”两个选项,设计师不需要记住类名。
每个属性对应一个类名:类型、阶段和数值组成 motion-rotate-loop-90,“变换参照”选择图标中心即
motion-origin-viewbox
- 导出。可以导出内嵌 CSS 的独立 SVG,浏览器直接打开即可播放;也可以只导出带类名的 SVG,由项目引入 CSS。导出面板同时给出所选触发方式的容器写法和使用说明。
第 3 步也可以交给 AI。AI 一次生成三套方案,每套使用不同的编排策略:语义驱动(根据图标含义选择动作,刷新图标旋转,铃铛摇晃)、节奏编排(各部件按空间顺序依次入场)和简约聚焦(只让最有表现力的一个部件动)。设计师选定一套后,仍可在属性面板中逐项调整。
AI 收到的参考资料是动效库的完整 CSS 源码,并被要求只使用其中定义的类名。词汇有限,AI 的输出就可预期;输出的是普通类名,设计师也能读懂和修改。这是选择原子化的主要原因。
图标和编辑进度保存在浏览器本地,导出过的 SVG 也可以重新导入继续编辑。AI 功能通过 OpenRouter 调用,密钥由使用者自行填写,仅保存在本地浏览器。
Skill
同一流程也被封装为 Claude Code 的 Skill。用户提供 SVG 后,Agent 根据图标语义从类名清单中挑选组合,写回 SVG,并生成预览页面供用户在浏览器中查看。预览脚本会用全部合法类名的快照校验输出,发现不存在的类名即报错,避免 AI 编造类名。多个图标可以交给子 Agent 并行处理。
结果
这套方案已用于腾讯云官网和部分产品的侧边栏。熟练的设计师一天可以完成约 15 个侧边栏图标的动效,制作效率约为原流程的 20 倍。
致谢
感谢 romboHQ 的 tailwindcss-motion,本方案的槽位设计与大部分预设值来自它;也感谢 Tailwind CSS 提供的原子化思路。