Communitygithub.com

motion-ui

指导 AI 代理如何规划、构建或裁剪“动态 UI”,以输出设计系统级别的令牌驱动方案。该流程涵盖运动规律、工作流与不可妥协原则。适合在新任务需处理此类工艺时使用。

motion-ui 是什么?

Motion UI 是一个基于研究的产品动态及手势操作指南,包含 19 个模式文件,每个文件都规定了规则、反模式、正误示例、无障碍、令牌、实现草稿和检查清单。该技能会指导 AI 代理按照标准化工作流决策——首先判断是否有动画的必要,选择机制(CSS 过渡、弹性动画或滚动驱动动画),从令牌中设置时长,并严格遵循不可妥协原则。本技能支持多种平台(如 Motion、React Spring、SwiftUI、Compose),并提供了详细的决策表与令牌默认值,确保动画在可及性、性能和用户控制方面达到 80% 或以上的评分。它特别适合需要在产品 UI 中实现或审查一致、高可及性动画的开发者或设计系统团队。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

在你喜欢的 AI 中提问

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

文档

Motion UI

基于研究的玩法指南,适用于产品 UI 动效和手势:包含 19 个模式文件,每个文件都有规则、反模式、正反示例、无障碍、令牌、实现草稿和检查清单。本文件定义了工作流程、不可妥协原则、决策表和默认令牌。打开模式文件获取详细信息。

  • 模式索引: references/INDEX.md 列出每个模式及其一句话规则。
  • 模式文件: references/patterns/<前缀>-<名称>.md。前缀包括 mfound(意图、节奏、编排、减少动效)、mspring(弹簧动效)、mgesture(拖拽、动量、边缘、面板、中断)、mtrans(进入/退出、空间原点、转场、微交互、滚动驱动)、mperf(性能)和 mref(审查模板、反模式)。
  • 入门令牌: assets/motion-tokens.css。时长、缓动和交错名称与值匹配 dashboard-ui 的 tokens.css。它在亮色和暗色模式下独立工作:它读取的 dashboard-ui 角色令牌以零特异性声明,因此 dashboard-ui 的 tokens.css 或项目自己的同名角色令牌无论加载顺序如何都会覆盖它们。
  • 数据 UI: 对于数字补间、图表过渡、关联探索、实时重算和加载状态,请使用 dashboard-ui 的 motion-* 和 prog-* 模式。本技能不重复它们。

工作流程

  1. 决定它是否应该动起来。 命名任务:反馈、连续性、导向、关注,或者(少数情况)愉悦。评估它发生的频率以及是否由键盘触发,然后根据下面的频率表选择行(mfound-purpose-and-frequency.md)。如果没有任务,或动作是键盘驱动的或一天发生 100+ 次,则停止:无动画。
  2. 选择机制。
    • 静止到静止和切换(菜单、对话框、开关):CSS 过渡(mfound-durations-and-easing.md),或弹簧 linear() 令牌(mspring-css-linear-and-tokens.md)。
    • 由手指或指针驱动,或可中断且带速度的:JS 弹簧(mspring-parameters-and-mapping.md, mgesture-interruptibility-and-velocity.md)。
    • 导航:视图过渡(mtrans-view-transitions-and-routes.md)。
    • 绑定到滚动位置的:滚动驱动动画(mtrans-scroll-driven-animations.md)。
  3. 从令牌设置时长。 按元素设置时长,按方向设置缓动,退出时长 = 0.75 × 进入时长,弹簧为时长加回弹。组件中不能使用原始值。
  4. 在空间中放置它。 在触发器处使用 transform-origin,镜像退出,保持前进和后退一致,并让永久 UI 保持静止(mtrans-spatial-origin-and-continuity.md)。对于顶层元素的进入/退出,遵循 mtrans-enter-exit-top-layer.md。
  5. 对于手势,按顺序应用:
    • 1:1 跟踪,10 px 阈值(mgesture-direct-manipulation-drag.md);
    • 释放时的投影和速度(mgesture-momentum-projection-and-snap.md);
    • 橡皮筋边界(mgesture-rubber-banding-and-bounds.md);
    • 面板和滑动规则(mgesture-sheets-and-swipe-to-dismiss.md)。
  6. 编排当几件事同时变化时:原因优先,然后是父元素,最后是子元素;交错 20–40 毫秒,有上限(mfound-choreography-and-stagger.md)。
  7. 让它便宜。 仅对 transform 和 opacity 进行动画,不使用全局 will-change,并在下一帧绘制反馈(mperf-compositor-will-change-and-inp.md)。
  8. 编写减少动画版本作为替换而非删除(mfound-reduced-motion-vestibular.md)。
  9. 从帧进行审查。
    • 运行反模式检查(mref-anti-patterns-gallery.md)。
    • 捕获帧序列(慢放 4 倍、完整和减少动画,外加一次中断运行)以及页面内审计。
    • 对 18 项检查清单进行评分(mref-motion-review-rubric.md)。达到 80% 或以上且无必须项为 0 时发布。
    • 报告每项发现作为 检查ID · 证据 · 修复,以及未检查的内容。

不可妥协原则

只有在有书面理由时才能违反其中一条。

是否动画及多长时间

  1. 每个动画都有一个命名任务。键盘触发和每天 100+ 次的操作没有动画。
  2. 无论动画时长如何,第一个视觉响应在输入后 100 毫秒内出现。
  3. 时长来自令牌(100 / 150 / 240 / 400 毫秒)。UI 界面中任何内容都不超过 400 毫秒;只有极少数情况可能达到 600 毫秒。
  4. 进入使用 ease-out;屏幕内移动使用 ease-in-out;用户等待的任何内容不使用 ease-in。退出时长约为进入的 0.75 倍。

弹簧和手势

  1. 弹簧用时长 + 回弹表示。UI 界面使用回弹 0,仅在带动量的手势后使用 0.1–0.2,且绝不用于透明度、颜色或数据值。
  2. 拖拽元素从抓取点 1:1 跟踪指针,拖拽过程中无过渡。约 10 px 后提交拖拽。
  3. 释放时,捕捉到投影位置最近的定位点,并在释放速度下开始归位弹簧。
  4. 边缘使用橡皮筋效果;没有任何东西在手指下硬停。
  5. 用户能影响的所有内容都可以从其当前屏幕值中断。没有动画队列且动画期间不阻塞输入。切换 UI 使用过渡,而不是关键帧。
  6. 破坏性手势动作在释放时提交并提供撤销。每个手势都有一个按钮或键盘等效项(WCAG 2.5.7)。

进入、退出和导航

  1. 绝不从 scale(0) 开始。从透明度 0 加上 scale 0.95–0.97 或 8–24 px 的位移进入,并在触发器处设置 transform-origin。
  2. 使用 @starting-style 进行进入,使用 display/overlay 与 allow-discrete 进行退出。可见的最终状态是默认值,因此不受支持的浏览器仍可工作。
  3. 路由过渡是渐进增强。先准备数据,再过渡。使用默认交叉淡入淡出或根据过渡类型 16–24 px 的方向偏移,命名 1-3 个共享元素,之后移动焦点。
  4. 弹出通知绝不应是唯一的信息来源。错误绝不自动关闭;撤销提示至少停留 8 秒,且其动作在提示外部也存在。计时器在悬停、焦点和隐藏标签时暂停(dashboard-ui comp-notifications-alerts.md)。

性能和安全

  1. 仅对 transform 系列属性和 opacity 进行动画处理,对于大于小控件的元素。没有 transition: all。will-change 是临时的,且仅遵循测量。
  2. 在 prefers-reduced-motion: reduce 下,将空间动画替换为 150 毫秒或更短的淡入淡出,保留反馈,保留 1:1 拖拽跟踪,并删除回弹。绝不发布全局 0.01ms 的开关,JS 动画也必须尊重设置。
  3. 在产品 UI 中不使用视差、滚动劫持、全屏缩放或空闲循环动画。超过 5 秒的自动播放需要暂停控制,并且每秒闪烁不超过 3 次。
  4. 从捕获的帧审查动画,而不是从代码或记忆。

决策表

频率 → 动效 (mfound-purpose-and-frequency.md)

频率动效
键盘触发,或每天 100+ 次(技能的截止点)无
每天几十次100–150 毫秒淡入淡出,可能放大缩小;无移动,无回弹
每次会话几次150–240 毫秒,可移动 8–24 px
罕见(首次运行、重大成功)最长 400–600 毫秒,允许带回弹的弹簧

机制 (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)

情况使用
颜色、透明度、状态变化CSS 过渡,linear 或 ease-out
可能中途反向的切换元素CSS 过渡(绝不使用关键帧)
静止到静止的空间动画并带弹簧感CSS 弹簧 linear() 令牌加上其自身的时长
拖拽或轻弹后释放,或带速度的重定向JS 弹簧(Motion, React Spring, SwiftUI, Compose)
布局变化(重排、调整大小、展开)FLIP, Motion layout, 或视图过渡
页面或路由变化视图过渡(同文档或跨文档)
滚动浏览进度滚动驱动动画

按元素的时长和缓动 (mfound-durations-and-easing.md)

元素时长曲线
按下、切换、悬停100 毫秒ease-out(按下缩放 0.97)
工具提示、菜单、弹出框进入 150 毫秒 / 退出 110 毫秒进入 ease-out,退出 ease-in 或淡出
对话框、弹出通知进入 240 毫秒 / 退出 180 毫秒进入 ease-out,退出 ease-in 或淡出
面板、抽屉240–400 毫秒--motion-ease-drawer,或拖拽后的弹簧
容器变换(卡片 → 详情)400 毫秒强调的
路由交叉淡入淡出150–250 毫秒linear

弹簧预设 (mspring-parameters-and-mapping.md)

令牌时长 / 回弹使用
spring-fast0.24 秒 / 0开关、小控件
spring-default0.3 秒 / 0菜单、面板归位、布局
spring-slow0.45 秒 / 0全屏表面
spring-snappy0.3 秒 / 0.15轻弹后释放、捕捉
spring-playful0.4 秒 / 0.3仅限罕见的愉悦效果

库参数(Motion, React Spring, SwiftUI, Material 3)来自 mspring-parameters-and-mapping.md 中的一个公式。

手势阈值 (mgesture-*)

值默认
拖拽开始 / 轴锁定10 px
速度采样窗口100 毫秒
投影减速度每毫秒 0.998(快速翻页为 0.99)
轻弹提交> 400 px/s
面板关闭拖拽超过其高度的 25%,或轻弹
橡皮筋常数0.55(常用近似值)

令牌默认值

完整集在 assets/motion-tokens.css 中。

组默认值
时长instant 0 · micro 100 · short 150 · medium 240 · long 400 毫秒 · 退出比率 0.75
缓动standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1)
弹簧(CSS)--motion-spring-{fast,default,slow,snappy,playful} 以及匹配的 -dur(360 / 450 / 670 / 420 / 660 毫秒)
几何scale-from 0.96 · press 0.97 · distance 8 / 16 / 24 px
编排stagger 30 毫秒 · max 300 毫秒(菜单中 150 毫秒)
减少动效空间令牌变为 0 或 1;淡入淡出保持其时长

如何应用本技能

  • 构建时:
    • 加载 assets/motion-tokens.css,或将其映射到项目的令牌。
    • 优先使用平台特性:CSS 过渡、@starting-style、<dialog> 和 popover API、视图过渡、滚动驱动动画、linear()。仅在需要手势和速度时才使用 JS 库。
    • 绝不使用 TypeScript any 类型。
  • 审查时: 先捕获帧,然后运行反模式库和检查清单。按严重性顺序报告检查项、分数、证据和修复的表格,并列明未检查的内容。
  • 当项目已有动效系统(M3、Carbon、自有令牌)时:以其令牌为准。将它们映射到这些角色上,并标记差距。
  • 当规则冲突时: 可访问性和用户控制(减少动效、可中断性、无滚动劫持)优先于表现力,频率优先于愉悦。

Individual skills in this repo

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

相关技能