鑫EN

基于原子 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,在入场动画的结果上叠加。元素可以先移入,再从当前位置继续浮动。

translate-x
translate-y
scale
scale-x
scale-y
rotate
shake
opacity
draw
translate-x translate-y
translate-x opacity
translate-y opacity
scale opacity
rotate scale
rotate opacity
shake scale
draw scale
draw opacity
上方是单个原子动效,下方是两两组合;将指针移到卡片上播放

针对图标的调整

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:左侧是图层,中间是画布,右侧是属性。

  1. 导入 SVG。SVGO 自动清理冗余节点,并为路径添加 pathLength="1",使其可以使用描边动画。
  2. 分组。动效通常作用于图标的语义部件,而不是单条路径。设计师可以拖拽分组,也可以让 AI 结合 SVG 源码和渲染图给出建议,例如把齿轮分为“外圈齿牙”和“中心圆孔”。
  3. 设置动效。为每组添加一条或多条动画,选择类型、阶段、数值、方向、延迟、循环次数和变换原点;时长和缓动可统一设置。motion-hold-start 与 motion-leave-reverse 在面板中显示为“初始状态”和“触发结束时”两个选项,设计师不需要记住类名。

每个属性对应一个类名:类型、阶段和数值组成 motion-rotate-loop-90,“变换参照”选择图标中心即 motion-origin-viewbox

  1. 导出。可以导出内嵌 CSS 的独立 SVG,浏览器直接打开即可播放;也可以只导出带类名的 SVG,由项目引入 CSS。导出面板同时给出所选触发方式的容器写法和使用说明。
导出物是 SVG 而非某个框架的组件,不使用 React 的页面也能直接引用

第 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 提供的原子化思路。