Communitygithub.com

Subtle Motion (微动效)

为任何网站(纯 HTML/CSS、React、Next、Vue、Svelte、Astro)添加精致、流畅的动画,使其感觉更自然而不显“生硬”,同时在低端手机上保持 60fps 的响应和无卡顿体验。

Subtle Motion (微动效) 是什么?

Subtle Motion 是一个综合性的 UI 动画技能,专为开发者设计,用于在不牺牲性能的前提下,为网站添加细微、精致的动效。它融合了迪士尼 12 条动画原则和相关的 UX 定律(如菲茨定律、希克定律、米勒定律等),提供了一套严格的规则和可复用的模式。该技能支持所有主流框架(React、Vue、Svelte、Astro、Next 等)和纯 CSS 项目。其核心思想是“动效只是点缀”,用户应该感受到网站的“流畅”,而不是注意到“动画”。它优先使用 CSS 过渡和动画,避免 JavaScript 库,并强制遵循诸如仅对 `transform` 和 `opacity` 进行动画、UI 动效时长 ≤300ms、对高频交互减少动画等硬性规定。工作流程包括先评估站点、对交互元素按频率分类、选择≤5个触点和验证。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/noni-was-taken/subtle-motion/tree/HEAD/skills/subtle-motion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

微动效

动效是调味品。用户应该感到网站“流畅”,而不是注意到“动画”。 来源:迪士尼的《生命的幻象》、Jon Yablonski 的《UX 定律》、Raphael Salaja 的 userinterface.wiki、Emil Kowalski(使用频率)。

硬性规则(不可违反)

  1. 仅对 transform 和 opacity 进行动画(谨慎使用 filter/clip-path)。切勿对 width、height、top、left、margin、padding、box-shadow 大小或 font-size 进行动画。需要阴影变化?淡入一个伪元素的 opacity。
  2. 轻快的时间:UI 动效在 300ms 以内。 按下 80–120ms,悬停 150ms,入场 200–300ms,退场 ≈ 入场的 70%。只有一次性的大场面可以延伸到 500ms。
  3. 小距离。 位移 2–16px,缩放 0.97–1.03,旋转 ≤ 6°。更大的变化会显得“像动画”。
  4. 缓入缓出。 运动切勿使用 linear。入场时缓出,退场时缓入。
  5. 使用频率:使用越频繁,越少动效。 键盘导航、命令面板、每天使用 100 次的标签页、列表选择:即时(0ms)或 ≤100ms 的淡入。对首次和稀有时刻进行动画,不要对重复动作。
  6. 多尔蒂阈值:在 100ms 内响应,在 400ms 内完成。 反馈(按压状态、待定状态)与输入在同一帧开始。比 400ms 更慢的操作显示进度。
  7. prefers-reduced-motion: reduce 消除所有移动。 透明度淡入可以保留。
  8. 悬停效果仅在 @media (hover: hover) 下生效。 否则触屏会获得粘性悬停状态。
  9. 首选 CSS,不加动画库,除非项目本身已包含。CSS 能做就避免 JS 循环。
  10. 切勿延迟或隐藏内容。 揭示效果必须确保即使 JS 失败也不隐藏内容,不阻止点击,或不让 LCP 元素在加载时动效。
  11. 分阶段:一次只聚焦一个动效。 每页最多约 5 个动效触点;同一时刻绝不要让两样东西争夺视线。
  12. will-change 仅在动画期间使用(或用于 ≤3 个持久元素)。
  13. 默认可中断。 可以在过程中切换状态(悬停、切换、开/关、标签指示器)的动效使用 transition,它会从当前位置重新定向。@keyframes 仅用于一次性瞬间(抖动、响铃、发送),它们会完全重新启动。
  14. 根据大小和发起者缩放时长。 小元素比大元素快(图标 100ms,卡片 250ms,面板 300ms)。用户发起 = 即刻;系统发起(提示通知、后台更新)可以使用较慢端。
  15. 闪烁不超过 3 次/秒;任何循环超过 5 秒的动效都需要暂停控制(或者不循环)。

原则,作为 UI 规则

选择适合触点的原则;切勿一次全用。每个原则对应下面的一个模式。

#原则在 UI 中的含义模式
1挤压与拉伸物体在受冲击时会压缩,运动时会拉伸:重量感按下、切换
2预备动作在大动作之前(发送、提交、飞出)的微小回拉发送按钮
3舞台呈现将视线引向一处:调暗同级元素,一次只做一个动效卡片聚焦
4Pose 到 Pose定义开始/结束状态;让浏览器进行补间transition,而非逐帧 JS
5跟随动作部件在主体停止后逐渐稳定(小幅度过冲)提示通知、徽标
6缓入缓出加速和减速,永远不要匀速标记
7弧线运动移动的元素沿曲线移动,而非直线飞入购物车
8次要动作为主要动作增添的小亮点成功光环
9轻快时间时长决定感觉;UI < 300ms标记
10夸张反馈超越真实以便瞬间传达到位(错误、成功)错误抖动
11扎实绘图/3D赋予平面事物深度和立体感翻转卡片
12吸引力所有细节的总和,在整个站点保持一致性验证通过
UX 定律对动效的影响模式
菲茨定律更大、更近的目标点击更快点击区域
更大的点击区域可点击区域 ≥ 44×44px,即使视觉元素更小点击区域
希克定律选择越多,决策越慢;不要同时动画多个选项交错上限
米勒定律将内容分块(约 7 项);分组揭示,而非逐项揭示交错上限
多尔蒂阈值<100ms 反馈,<400ms 整体,否则显示进度待定状态
波斯特尔定律接受混乱输入,输出来干净的输出;温和地动画清洗过程输入格式化
雅各布定律使用常规动效(菜单从触发器下拉弹出,模态框从中心淡入+缩放)覆盖层
使用频率频繁 = 减少动效规则 5

工作流程

  1. 首先读取站点。 框架、CSS 方式(Tailwind、CSS Modules、纯 CSS)、现有的动效和标记。重用它们。
  2. 为每个交互元素按频率分类:稀有(注册、结账、成功)、偶尔(卡片、区块、模态框)、频繁(导航、标签页、命令面板、列表行)。频繁项使用 ≤100ms 或不做动效。
  3. 选择 ≤5 个触点,按感觉/成本排序:
    1. 按钮/链接:按下压缩 + 点击区域(原则 1,菲茨定律)
    2. 表单反馈:错误抖动、成功光环、待定状态(10,8,多尔蒂阈值)
    3. 卡片:悬停提升,可选的翻转(11)
    4. 区块:滚动揭示,分块交错(6,米勒定律)
    5. 覆盖层/提示通知:入场/退场带跟随动作(5,雅各布定律)
  4. 一次性全局添加标记。
  5. 将模式应用于选定的触点。
  6. 验证(最后一部分)。在验证完成前未完成。
  7. 报告:每个触点包含文件:行数,其应用的原则,以及如何查看。

标记(一次性全局添加)

:root {
  --ease-out: cubic-bezier(.23, 1, .32, 1);       /* 入场,悬停 */
  --ease-in: cubic-bezier(.55, 0, 1, .45);        /* 退场 */
  --ease-in-out: cubic-bezier(.65, 0, .35, 1);    /* 在屏幕上移动 */
  --ease-settle: cubic-bezier(.34, 1.4, .64, 1);  /* 跟随动作:~4% 过冲 */
  /* 弹簧感,可中断;不支持 linear() 的浏览器回退为 `ease` */
  --ease-spring: linear(0, .07 3%, .29 9%, .62 18%, .86 28%, 1.01 40%, 1.03 50%, 1.015 65%, 1);
  --dur-press: 100ms;
  --dur-fast: 150ms;
  --dur-base: 250ms;
  --dur-slow: 300ms;
  --rise: 8px;
}
@media (prefers-reduced-motion: reduce) {
  :root { --rise: 0px; }
  *, *::before, *::after {
    animation-duration: 1ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 1ms !important;
    scroll-behavior: auto !important;
  }
}

Tailwind 项目?将这些放入 @theme / tailwind.config 的 extend 中,而不是新建一个 CSS 文件。

模式

按下:压缩 (1) + 点击区域 (菲茨定律)

.btn {
  position: relative;
  transition: transform var(--dur-fast) var(--ease-out), background-color var(--dur-fast) var(--ease-out);
}
@media (hover: hover) { .btn:hover { transform: translateY(-1px); } }
.btn:active { transform: scale(.97); transition-duration: var(--dur-press); }

/* 小图标按钮:放大点击区域,而非视觉元素 */
.icon-btn { position: relative; }
.icon-btn::before { content: ""; position: absolute; inset: 50% auto auto 50%; width: 44px; height: 44px; translate: -50% -50%; }

切换:挤压与拉伸 (1)

旋钮在移动时拉伸,到位后稳定。

.switch .knob { transition: transform var(--dur-base) var(--ease-settle); }
.switch[aria-checked="true"] .knob { transform: translateX(20px); }
.switch:active .knob { transform: scaleX(1.2); transform-origin: left; }
.switch[aria-checked="true"]:active .knob { transform: translateX(20px) scaleX(1.2); transform-origin: right; }

发送/提交:预备动作 (2)

仅在罕见的“提交”操作上使用。回拉 2px,然后前进。

@keyframes send { 0% { transform: none } 30% { transform: translate(-2px, 2px) } 100% { transform: translate(24px, -24px); opacity: 0 } }
.send.is-sending svg { animation: send 280ms var(--ease-in-out) forwards; }

卡片聚焦:舞台呈现 (3)

@media (hover: hover) {
  .grid:has(.card:hover) .card:not(:hover) { opacity: .6; }
}
.grid .card { transition: opacity var(--dur-base) var(--ease-out); }

仅在需要选择一个的密集网格中使用。在人们阅读的内容上跳过。

卡片提升 + 可选翻转:扎实绘图/3D (11)

.card { position: relative; transition: transform var(--dur-base) var(--ease-out); }
.card::after {
  content: ""; position: absolute; inset: 0; border-radius: inherit; pointer-events: none;
  box-shadow: 0 12px 32px -12px rgb(0 0 0 / .25);
  opacity: 0; transition: opacity var(--dur-base) var(--ease-out);
}
@media (hover: hover) {
  .card:hover { transform: translateY(-3px); }
  .card:hover::after { opacity: 1; }
}

翻转(仅用于展示项目,如产品、定价或信用卡;≤6°,指针设备专用,rAF 节流):

if (matchMedia('(hover: hover) and (prefers-reduced-motion: no-preference)').matches) {
  for (const el of document.querySelectorAll('.tilt')) {
    let raf = 0;
    el.addEventListener('pointermove', (e) => {
      cancelAnimationFrame(raf);
      raf = requestAnimationFrame(() => {
        const r = el.getBoundingClientRect(); // 每帧只读取一次,不按过渡读取
        const x = (e.clientX - r.left) / r.width - .5, y = (e.clientY - r.top) / r.height - .5;
        el.style.transform = `perspective(800px) rotateX(${-y * 6}deg) rotateY(${x * 6}deg)`;
      });
    });
    el.addEventListener('pointerleave', () => { cancelAnimationFrame(raf); el.style.transform = ''; });
  }
}

提示通知/徽标:跟随动作 (5)

.toast { transition: transform var(--dur-slow) var(--ease-settle), opacity var(--dur-fast) var(--ease-out); }
.toast[data-state="closed"] { transform: translateY(12px); opacity: 0; transition-timing-function: var(--ease-in); }

过冲仅用于到达的元素(提示通知、徽标、计数器),绝不用于布局或文本块。

飞入购物车:弧线运动 (7)

将 X 和 Y 轴分别放在两个嵌套元素中,使用不同的缓动函数;路径呈曲线。

.fly-x { transition: transform 300ms linear; }
.fly-y { transition: transform 300ms var(--ease-in); }
.flying .fly-x { transform: translateX(var(--dx)); }
.flying .fly-y { transform: translateY(var(--dy)) scale(.4); }

在添加 .flying 类之前,通过一次 getBoundingClientRect() 读取设置 --dx/--dy。

成功光环:次要动作 (8)

.btn.is-success::after {
  content: ""; position: absolute; inset: -4px; border-radius: inherit; border: 2px solid currentColor;
  animation: ring 400ms var(--ease-out) forwards; pointer-events: none;
}
@keyframes ring { from { opacity: .6; transform: scale(.95) } to { opacity: 0; transform: scale(1.15) } }

错误抖动:夸张反馈 (10)

@keyframes shake { 20%,60% { transform: translateX(-4px) } 40%,80% { transform: translateX(4px) } }
.field[aria-invalid="true"] { animation: shake 280ms var(--ease-in-out); }

通过移除并重新添加属性来重新触发。始终配合文本消息(无障碍)。

待定状态:多尔蒂阈值

按下时立即反馈;如果操作耗时 >400ms,在按钮内显示旋转/进度(保持其宽度固定以避免布局偏移)。优先使用乐观 UI:显示结果,出错时回滚。

杂乱输入 → 干净输出:波斯特尔定律

在 blur 时格式化(电话号码、信用卡号、日期),而不是在每次按键时。通过 150ms 的不透明度变化交叉淡化值,不做移动。

滚动揭示:缓入/缓出 (6) + 分块 (米勒定律、希克定律)

默认内容可见;仅当 JS 确认可以揭示时才隐藏。

.js .reveal {
  opacity: 0; transform: translateY(var(--rise));
  transition: opacity var(--dur-slow) var(--ease-out), transform var(--dur-slow) var(--ease-out);
  transition-delay: calc(min(var(--i, 0), 5) * 50ms);
}
.js .reveal.in { opacity: 1; transform: none; }
document.documentElement.classList.add('js');
const io = new IntersectionObserver((entries) => {
  for (const e of entries) if (e.isIntersecting) { e.target.classList.add('in'); io.unobserve(e.target); }
}, { rootMargin: '0px 0px -10% 0px' });
document.querySelectorAll('.reveal').forEach((el) => io.observe(el));
  • 使用 style="--i: n" 进行交错;上限为 6 步(米勒定律)。长列表作为一组揭示。
  • 只揭示一次。跳过折叠区域以上的内容。
  • 框架:使用相同的 CSS;在挂载副作用中运行观察者,在卸载时断开连接。

覆盖层:雅各布定律

仅使用常规动效:下拉菜单从触发器处生长(transform-origin 在触发器一侧),模态框从中心淡入 + 缩放 0.98→1,面板从边缘滑入。优先使用原生元素:<dialog> / popover 配合 @starting-style。

dialog, [popover] {
  opacity: 0; transform: translateY(4px) scale(.98);
  transition: opacity var(--dur-fast) var(--ease-in), transform var(--dur-fast) var(--ease-in),
              overlay var(--dur-fast) allow-discrete, display var(--dur-fast) allow-discrete;
}
dialog[open], [popover]:popover-open {
  opacity: 1; transform: none;
  transition-timing-function: var(--ease-out); transition-duration: var(--dur-base);
}
@starting-style {
  dialog[open], [popover]:popover-open { opacity: 0; transform: translateY(4px) scale(.98); }
}

每天多次用键盘打开的命令面板/菜单:根据使用频率规则跳过过渡。

标签页:滑动的文件夹表面(非下划线强调装饰)

AI/模板特征性的方式是细下划线强调装饰,而非动效本身。使用熟悉的物理形状(雅各布定律)并让该形状移动:

  • 文件夹式标签页(推荐):所选标签的表面与面板合并并滑动到点击的标签。
  • 分段控制:适用于 2–4 个选项;按下段以相同方式滑动。

使标签等宽,这样表面只需要 translateX(无需宽度或 scaleX,这会扭曲圆角和边框)。使用 ≤150ms 的过渡以保持可中断性。内容立即切换(使用频率)。

.tabs { position: relative; display: flex; gap: 2px; border-bottom: 1px solid var(--line); }
.tabs [role=tab] { position: relative; z-index: 1; flex: 0 0 96

…

[因翻译截断]

相关技能