Communitygithub.com

Motion Craft

设计 GPU 加速的 Web 动画,涵盖 Web Animations API、滚动驱动动画、FLIP 技术、缓动系统和无障碍(prefers-reduced-motion)。当用户要求创建动画、过渡、滚动效果、页面过渡或 Web UI 的交互动效时使用。不要用于基于 Canvas 的动画(Three.js、PixiJS)、视频编辑或非 Web(原生移动端)动效设计。

Motion Craft 是什么?

Motion Craft 是一个专注于为 Web UI 创建高性能、有意义的动画的专业工具集。它强调动画的目的是沟通而非装饰,要求每一帧动画都必须有其存在的价值。该技能提供了完整的动画决策框架,帮助开发者在设计动画前从四个关键问题入手:是否应该动画、动画的目的是什么、使用何种缓动曲线以及动画应该多快。它涵盖了从 CSS 过渡和关键帧动画到 Web Animations API (WAAPI)、滚动驱动动画(ScrollTimeline/ViewTimeline)、FLIP 技术以及剪切路径动画等多种实现方式。Motion Craft 特别关注性能优化,遵循 60fps 黄金规则,限制动画只作用于 `transform` 和 `opacity` 属性以避免布局重排。同时,它提供了统一的评审格式,要求使用 Before|After|Why 表格来审查 UI 动画代码,并包含了丰富的实际代码示例和最佳实践,如非对称进入/退出时序、悬停延迟跳过、压感删除模式以及弹出层原点感知等。该技能还支持无障碍设计,要求使用 `prefers-reduced-motion` 媒体查询来尊重用户的运动偏好。支持的平台包括所有现代浏览器,但滚动驱动动画在 2026 年仍为 Chrome/Edge 独占,需要为 Firefox/Safari 提供回退方案。

兼容平台~Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/EliasOulkadi/shokunin/tree/HEAD/.pack/skills/motion-craft

在你喜欢的 AI 中提问

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

文档

Motion Craft 是做什么的?

能够沟通而不是装饰的动画。每一帧都必须证明其存在的价值。

灵感来源于 Emil Kowalski(Linear、Sonner、Vaul)、Paul Lewis(Google Chrome)以及 CSS 动画工作组。

工作流程

动画决策框架

在编写任何动画代码之前,按顺序回答以下四个问题。

1. 这个元素是否应该动画?

频率决策原因
每天 100+ 次(键盘快捷键、命令面板、搜索切换)永远不要动画。动画会让频繁的操作感觉延迟。Raycast 没有打开/关闭动画。最佳选择。
每天几十次(悬停效果、列表导航)移除或大幅减少用户会在重复交互中注意到动画延迟
偶尔(模态框、抽屉、提示)标准动画这是动效的正确使用场景
少见/首次(引导、确认、庆祝)增加惊喜感这些瞬间值得更长时间、更丰富的动画

永远不要为键盘触发的操作添加动画。 这些操作每天重复数百次。

2. 动画的目的是什么?

每个动画都必须有一个清晰的答案来解释“为什么这个元素会动?”

目的示例有效?
空间一致性提示从同一方向进入和退出?
状态指示按钮变形以显示“已发送”?
反馈按钮按下时缩小,确认界面收到了用户的输入?
防止突兀变化元素淡入而非突然出现?
解释营销动画展示某个功能的工作原理?
“看起来酷”并且用户经常看到它多余的运动?

3. 应该使用什么缓动?

场景缓动CSS
元素进入ease-out(起始快,感觉响应迅速)cubic-bezier(0, 0, 0.2, 1)
元素退出ease-in(起始慢,短暂吸引注意力后加速离开)cubic-bezier(0.4, 0, 1, 1)
屏幕内移动/变形ease-in-outcubic-bezier(0.4, 0, 0.2, 1)
悬停/颜色变化easecubic-bezier(0.25, 0.1, 0.25, 1)
恒速运动(跑马灯、进度条)linearcubic-bezier(0, 0, 1, 1)
UI 交互(按钮、工具提示、下拉菜单)强 ease-outcubic-bezier(0.23, 1, 0.32, 1)

关键:永远不要在 UI 进入动画中使用 ease-in。 一个使用 ease-in 且时长为 300ms 的下拉菜单比同样时长使用 ease-out 的感觉更慢,因为 ease-in 延迟了初始运动——这正是用户最关注的那个瞬间。

4. 动画应该多快?

元素时长缓动
按钮按下反馈(缩放)100-160mscubic-bezier(0.23, 1, 0.32, 1)
工具提示进入/退出125-200mscubic-bezier(0.23, 1, 0.32, 1)
下拉菜单/选择/弹出窗150-250mscubic-bezier(0.23, 1, 0.32, 1)
悬停变换(缩放、上提)200mscubic-bezier(0.23, 1, 0.32, 1)
模态框/对话框进入200-300mscubic-bezier(0, 0, 0.2, 1)
模态框/对话框退出150-200mscubic-bezier(0.4, 0, 1, 1)
抽屉/面板进入200-400mscubic-bezier(0.32, 0.72, 0, 1)(类 iOS)
提示进入300-400mscubic-bezier(0.23, 1, 0.32, 1)
提示退出200-300mscubic-bezier(0.4, 0, 1, 1)
页面过渡300-400mscubic-bezier(0.4, 0, 0.2, 1)
滚动揭示(淡入 + 上滑)400-800mscubic-bezier(0.16, 1, 0.3, 1)
加载闪烁1000-1500ms(无限)linear
长按删除(按下)2000mslinear(故意缓慢)
长按删除(释放)200mscubic-bezier(0.23, 1, 0.32, 1)(快速)
营销/解释性800-3000ms可变,取决于叙事

规则:UI 动画应保持在 300ms 以下。 一个 180ms 的下拉菜单感觉比一个 400ms 的明显更灵敏。

自定义缓动曲线

内置的 CSS ease / ease-in / ease-out 太弱了。使用这些更强的自定义变体:

:root {
  --ease-out-strong: cubic-bezier(0.23, 1, 0.32, 1);     /* UI 交互,Emil 的签名 */
  --ease-in-out-strong: cubic-bezier(0.77, 0, 0.175, 1);  /* 屏幕内移动 */
  --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);          /* 类 iOS 抽屉 */
  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);         /* 缓慢揭示,戏剧性 */
  --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);       /* 备选强 ease-out */
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);       /* 轻微过冲,谨慎使用 */
}

来源:easing.dev, easings.co


60fps 黄金规则

每帧 16.67ms。使用 Chrome DevTools 的 Performance 面板验证。仅对 transform 和 opacity 属性进行动画。

属性GPU 合成?触发操作
transform(平移、缩放、旋转)? 是仅合成
opacity? 是仅合成
filter?? 有时绘制 + 合成
clip-path?? 有时绘制 + 合成
width, height, top, left, margin, padding, border-width? 否布局 + 绘制 + 合成
box-shadow? 否绘制 + 合成
color, background-color? 否仅绘制

审查格式(必需)

在审查 UI 动画代码时,你必须使用一个包含 Before | After | Why 列的标记表。不要使用包含“Before:”和“After:”的列表,并将它们放在单独的行上。

正确格式:

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out指定确切属性;避免使用 all,这会触发布局重算
transform: scale(0)transform: scale(0.95); opacity: 0现实世界中没有任何东西是从虚无中出现的
下拉菜单使用 ease-incubic-bezier(0.23, 1, 0.32, 1)ease-in 起始缓慢——感觉迟钝。强 ease-out 提供即时反馈
按钮没有 :active 状态在 :active 上使用 transform: scale(0.97)按钮必须对按压有响应感
弹出窗使用 transform-origin: centertransform-origin: var(--radix-popover-content-transform-origin)弹出窗应基于其触发器进行缩放。模态框保持居中。
transition: 300ms 没有 prefers-reduced-motion@media (prefers-reduced-motion: reduce) { transition-duration: 0.01ms }WCAG 2.1 要求支持减少运动
在 Framer Motion 中使用 animate={{ x: 100 }}animate={{ transform: "translateX(100px)" }}Framer Motion 的 x/y 并非硬件加速。使用 transform 字符串以获得 GPU 加速。

错误格式(永远不要这样做):

Before: transition: all 300ms
After: transition: transform 200ms ease-out

CSS 过渡(UI 首选)

CSS 过渡是可中断的——它们可以在动画中途重新定向。关键帧会从头重新启动。对于任何可能被快速触发的交互(提示、切换、下拉菜单),过渡能产生更平滑的效果。

.button {
  transition: transform 160ms ease-out;
}
.button:active {
  transform: scale(0.97);
}

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}

非对称进入/退出时序

进入可以慢些(用户在决定),退出必须快(系统在响应):

.overlay {
  transition: clip-path 200ms ease-out;  /* 释放:快 */
}
.button:active .overlay {
  transition: clip-path 2s linear;       /* 按压:慢且刻意 */
}

工具提示:在后续悬停时跳过延迟

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}
.tooltip[data-instant] {
  transition-duration: 0ms;
}

使用 @starting-style 的进入状态(截至 2026 年仅 Chrome 支持,尚未成为基线)

.toast {
  opacity: 1;
  transform: translateY(0);
  transition: opacity 400ms ease-out, transform 400ms ease-out;

  @starting-style {
    opacity: 0;
    transform: translateY(100%);
  }
}

注意:@starting-style 和滚动驱动动画(animation-timeline: view(), animation-timeline: scroll())截至 2026 年仍仅限 Chrome。对跨浏览器支持,请使用 JavaScript 回退方案。

长按删除模式

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;   /* 释放:快 */
}
.button:active .overlay {
  clip-path: inset(0 0 0 0);
  transition: clip-path 2s linear;        /* 按压:慢且刻意 */
}

按钮 - 触觉反馈

每个可按压元素都需要物理响应。

.button {
  transition: transform 160ms cubic-bezier(0.23, 1, 0.32, 1);
}
.button:active {
  transform: scale(0.97);
}

缩放必须微妙(0.95-0.98)。适用于所有可按压元素——按钮、卡片、列表项、标签。


弹出窗 - 原点感知

弹出窗从它的触发器缩放,而不是中心。模态框保持居中。

/* Radix UI */
.popover {
  transform-origin: var(--radix-popover-content-transform-origin);
}
/* Base UI */
.popover {
  transform-origin: var(--transform-origin);
}
/* 模态框(始终居中) */
.modal {
  transform-origin: center;
}

无论用户是否注意到,这都无关紧要。总之,看不见的细节会叠加。


交错动画

当多个元素一起进入时,交错显示它们。

.item {
  opacity: 0;
  transform: translateY(8px);
  animation: fadeIn 300ms ease-out forwards;
}
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
.item:nth-child(4) { animation-delay: 150ms; }

@keyframes fadeIn {
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

保持交错延迟短(项目之间 30-80ms)。绝不要让交互在交错动画播放期间被阻塞。


CSS 动画(关键帧)

用于预定的、非动态的动画。关键帧在中断时会从头重新启动——避免在 UI 中使用。

@keyframes enter-right {
  from { opacity: 0; transform: translateX(16px); }
  to   { opacity: 1; transform: translateX(0); }
}
.enter {
  animation: enter-right 300ms ease-out forwards;
}

弹簧动画

弹簧比基于时长的动画感觉更自然,因为它们模拟了真实物理。它们在中途中断时能保持速度。

何时使用弹簧

  • 带有动量的拖拽交互
  • 感觉“有生命”的元素(Apple 灵动岛风格)
  • 可以在动画中途中断的手势
  • 装饰性的鼠标追踪交互

Apple 方法(推荐 - 更容易推理)

{ type: "spring", duration: 0.5, bounce: 0.2 }

传统物理方法(更多控制)

{ type: "spring", stiffness: 100, damping: 10, mass: 1 }

保持弹跳轻微(0.1-0.3)。在大多数 UI 中避免弹跳。仅用于拖拽消除和有趣的交互。

基于弹簧的鼠标交互

import { useSpring } from 'framer-motion'

const springX = useSpring(mouseX * 0.1, { stiffness: 100, damping: 10 })

没有弹簧:感觉不自然,瞬时。有弹簧:感觉自然,有动力。


WEB 动画 API (WAAPI)

编程式 CSS 动画。硬件加速、可中断、无需库。

const element = document.querySelector('.card')

const animation = element.animate([
  { transform: 'scale(1)', opacity: 1 },
  { transform: 'scale(0.95)', opacity: 0.7 },
], {
  duration: 200,
  easing: 'cubic-bezier(0.23, 1, 0.32, 1)',
  fill: 'both',
})

animation.pause()
animation.play()
animation.reverse()
animation.finish()
animation.finished.then(() => console.log('done'))

在高负载下,WAAPI 胜过 Framer Motion——它在主线程之外运行。用于动态、可中断的动画,当 CSS 关键帧无法满足时。


滚动驱动动画

浏览器支持说明: 滚动驱动动画(animation-timeline: view() 和 scroll())截至 2026 年仍仅限 Chrome/Edge,尚未成为基线。请通过 IntersectionObserver 为 Firefox/Safari 提供 JS 回退方案。

ViewTimeline(元素进入/离开视口)

@keyframes fade-up {
  from { opacity: 0; transform: translateY(20px); }
  to   { opacity: 1; transform: translateY(0); }
}
.reveal {
  animation: fade-up 600ms linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 100%;
}

ScrollTimeline(页面滚动位置)

@keyframes shrink {
  from { height: 80px; }
  to   { height: 50px; }
}
.site-header {
  animation: shrink 300ms linear both;
  animation-timeline: scroll();
  animation-range: 0 200px;
}

滚动联动视差(原生 JS)

const layers = document.querySelectorAll('[data-parallax]')
window.addEventListener('scroll', () => {
  const scrollY = window.scrollY
  layers.forEach(layer => {
    const speed = parseFloat(layer.dataset.parallax) || 0.3
    layer.style.transform = `translateY(${scrollY * speed}px)`
  })
})

FLIP 技术

用于布局动画——对改变位置/大小的元素进行动画。

function animateLayout(element, callback) {
  const first = element.getBoundingClientRect()
  callback()
  const last = element.getBoundingClientRect()

  const dx = first.left - last.left
  const dy = first.top - last.top
  const dw = first.width / last.width
  const dh = first.height / last.height

  element.animate([
    { transform: `translate(${dx}px, ${dy}px) scale(${dw}, ${dh})` },
    { transform: 'translate(0, 0) scale(1, 1)' },
  ], {
    duration: 300,
    easing: 'cubic-bezier(0.4, 0, 0.2, 1)',
  })
}

剪切路径动画(CLIP-PATH)

CSS 中最强大的动画工具之一。硬件加速。

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;
}
.visible {
  clip-path: inset(0 0 0 0);
}

用于:长按删除、滚动时图像揭示、比较滑块、标签页的无缝颜色过渡。


感知性能

动画的速度直接影响…

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能