Communitygithub.com

antheo-motion

决定元素是否应该移动,并赋予其精确的时长、缓动曲线和距离(按压、悬停、菜单、对话框、面板、拖拽、页面过渡),同时处理减弱动效模式。当界面感觉卡顿、死板或过度动画时,当抽屉或拖拽手感不对时,或在发布任何动画之前使用。

antheo-motion 是什么?

Antheo Motion 是一个专注于 UI 动画设计的 AI 技能,它帮助开发者决定界面中的每个变化是否值得以动画呈现,并为其分配精确的时长、缓动和距离。该技能基于一个核心原则:动画应传递信息,否则便是噪音。它提供了详细的决策树、时长表(从 100ms 到 400ms)以及针对菜单、对话框、面板、提示框等常见 UI 组件的开闭动画对。Antheo Motion 强调性能与无障碍,限制仅使用 `transform` 和 `opacity` 等高效属性,并内置了对 `prefers-reduced-motion` 的无障碍支持。它适用于 Antheo 生态系统(moment, tokens, access),并提供了用于审计整个应用动画的工具和脚本,确保动画平滑、可中断且有意义。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

在你喜欢的 AI 中提问

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

文档

Antheo Motion

动效是关于变化的信息:某物到达、离开、移动或回应了你。不解释任何东西的动效是噪音;没有动效的变化则是跳跃。此技能决定哪些变化需要移动,并为每个变化赋予精确的时长。组件的标志性瞬间属于 antheo-moment;时长令牌由 antheo-tokens 生成;减弱动效需求由 antheo-access 检查。审计、删减或规划整个应用的动效是 antheo-motion-audit 的职责。

按此顺序决定

  1. 列出屏幕上的每一个变化:什么打开、关闭、出现、离开、重新排序、更新、加载、成功或失败。
  2. 标记人们看到每个变化的频率:每天多次、每天一次、或很少。
  3. 为每个变化赋予下表中的时长和缓动。
  4. 将那个罕见的、有意义的事件(如果有的话)交给 antheo-moment。
  5. 快速检查两次,并使用减弱动效模式,然后录制它并读取帧(见下文)。

命名移动的原因,否则不要移动

“这个移动,是为了让用户理解___。” 如果无法完成这个句子:不要动画。

看到越频繁,移动越少

频率规则
每天多次(打字、行、标签、菜单、调色板)最多 150ms,移动 4px;从键盘触发时,只做短暂的淡入淡出
每天一次(对话框、面板、提示框、保存)短暂的进入和更快的退出,150 到 300ms
很少(首次成功、已下订单)标志性瞬间的唯一位置(antheo-moment)

时长,按场景

令牌值适用场景
--dur-instant100ms颜色和不透明度反馈
--dur-fast150ms按压、悬停进入和离开、菜单或工具提示打开
--dur-base200ms元素离开、对话框关闭、值或文本切换、提示框进入
--dur-open250ms对话框打开、标签、手风琴、卡片调整大小
--dur-slow300ms面板或抽屉升起、标记滑动
--dur-page400ms页面或共享元素过渡

界面动效保持在 300ms 或以下;页面移动保持在 400ms 或以下。加载器、进度条和滚动相关的动效使用 linear。

开与关,成对出现

元素打开关闭
菜单、弹出框、选择框150ms,从 scale(0.97) 和淡入开始,以触发器为原点120ms
工具提示400ms 延迟,然后 150ms 淡入;如果在前一个关闭后的 300ms 内触发,则立即显示立即
对话框250ms:上升 8px,淡入,从 scale(0.96) 缩放200ms
面板、抽屉300ms,从边缘进入,全程完全不透明(无淡出,无模糊)200ms
提示框200ms,上升 12px200ms,按原路返回
手风琴、高度展开250ms,grid-template-rows: 0fr 到 1fr200ms

永远不要延迟关闭或悬停离开:而是缩短持续时间。

进入和离开使用同一个曲线

--ease-out cubic-bezier(0.23, 1, 0.32, 1) 用于所有进入或离开的元素。--ease-in-out cubic-bezier(0.77, 0, 0.175, 1) 仅用于从一个屏幕位置移动到另一个屏幕位置的元素。--ease-in 仅用于被永久丢弃的元素。退出比进入更快,并且大约只移动一半的距离。

小距离,绝不自零开始

值切换或弹出框移动 4px,对话框移动 8px,提示框移动 12px,英雄组件移动 24px;只有面板才从边缘全长移动。从 scale(0.96)(菜单用 0.97,工具提示用 0.98)和 opacity 0 进入,永远不要从 scale(0) 开始。文本或图标切换时模糊 4px,大表面时模糊 8px,200ms 以下的交叉淡入时模糊 2px。

可以动画的属性

默认情况下为 transform 和 opacity(以及颜色);根据需要添加短时的 filter 模糊、clip-path 和用于高度揭示的 grid-template-rows。永远不要使用 transition: all,永远不要使用 width、height、top、left 或 margin,也永远不要直接使用 box-shadow:将变化的阴影放在一个伪元素上并淡入淡出它。will-change 仅在性能分析后使用。

从触发器开始生长

菜单和弹出框采用触发器的 transform-origin(Radix 暴露了 --radix-popover-content-transform-origin);模态框保持居中;面板从其所在的边缘进入;共享元素(如卡片展开为其页面)在两侧使用同一个 view-transition-name。

状态变化用过渡,一次性动画用关键帧

用户可以切换的任何内容都使用 CSS 过渡或弹簧,它们可以在中途反向;关键帧仅用于只播放一次的内容。

交错 30 到 40ms,前八个,总共不超过 300ms

英雄组件的三到六个部分使用 60 到 80ms 的交错。永远不要交错经常打开的元素,并且永远不要在项目到达时阻止点击。

弹簧仅在手动移动时使用

开关旋钮、释放的拖拽、滑动的分段选择器。控件的弹跳为 0 到 0.2(过冲保持在轨道内),罕见的庆祝效果可达到 0.45;最多一次摆动。拖拽跟随手指,无过渡,释放时从释放速度开始弹簧运动;如果手指甩动速度超过约 0.11px/ms,或者面板已移动了 min(64px, 15%) 的高度,则面板关闭,否则弹簧弹回(references/gestures.md)。

没有跳跃

每个变化的值都必须被看到变化;被移除的行应闭合其间隙;为将出现的元素预留空间(布局偏移小于 0.1)。加载时,最多一次进入动画。切换主题时,关闭一帧的过渡。

减弱动效将故事保留在淡入淡出中

在 prefers-reduced-motion: reduce 下,移动、缩放、模糊、视差和弹跳变为 150 到 200ms 的不透明度交叉淡入;开关旋钮立即移动;自动播放的循环停止。任何单独移动超过 5 秒的内容都必须有暂停控制(WCAG 2.2.2);每秒闪烁不超过 3 次(2.3.1)。

在整个应用范围内

  1. 查找: 列出每个变化、其查看频率、当前如何移动、应该怎样移动的表格。
  2. 改进: 为每个数值使用令牌,补全缺失的退出动画,将变换原点设置在触发器处,一次一个模式。
  3. 移除: 任何在每次加载时都动画、在每天多次的操作上播放、延迟下一个操作、在用户阅读时循环、或在常规操作上运行超过 300ms 的动效。不确定时,移除之。
  4. 批准或驳回: 一个解释原因的句子,仅使用令牌,仅允许使用的属性,退出比进入更快,处理了减弱动效,在正常速度和 4 倍 CPU 降速下查看。

检查它

快速点击所有内容两次:动画反转,绝不跳跃。打开菜单二十次:依然快速。将 CPU 降速 4 倍:依然流畅。开启减弱动效:没有元素移动。

观看它:静态图无法判断动效

静态状态的截图说明不了它如何移动,而每个检查者都读取静态帧。因此,为你制作的每个动效录制视频并查看帧,然后才能认为完成:

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

它会将页面减速至 0.1 倍(CSS、Web Animations 和 JavaScript 时钟),执行此操作,并将元素的 12 帧放在一张表上,每帧带有时戳。打开表并读取每一帧:

  • 每一帧本身看起来都是完整的:没有硬边滑动、没有错误的颜色闪烁、没有空框
  • 每个变化的值都被看到变化:一个应该滚动的数字不会在指针还在移动时突然跳变
  • 没有回流或在中间跳跃;第一帧已经响应了按压
  • 最终状态稳定在应处位置:弹簧轻微过冲并回弹,控件不会突然停止
  • 使用 --reduce 和 --dark 再次录制:故事仍被讲述,暗色模式没有出现亮色闪烁

修复帧显示的问题,再次录制,并保留最后一张表作为证据。

生成式 UI 在这里做错的地方

在宣布完成之前,对照 references/habits.md 检查每一项:transition: all · 内容在脚本揭示前隐藏 · 一刀切的减弱动效重置 · 淡入或滑入的焦点环 · 影响性能的动效 · 不可点击元素上的悬停效果 · 读取一个未定义的名称的过渡。

何时需要更多动效

目的和频率规则决定;数字是默认值。游戏、创意工具、学习产品或用户要求的品牌时刻可以有更多和更长的动效。它仍然必须立即响应用户输入,永不阻塞下一个操作,可在中途中断,尊重减弱动效,并展示其代价:即使在低端手机上出现缓慢的帧,无论风格如何,都是一个发现。

完成清单

  • 每个变化都列出其查看频率;频繁的变化几乎不动;键盘操作不产生移动
  • 时长和缓动来自令牌;使用上述开闭动画对;没有延迟关闭
  • 仅使用允许的属性;变换原点在触发器;不从 scale(0) 开始
  • 减弱动效变为交叉淡入;超过 5 秒的循环可以暂停
  • 快速点击两次,在 4 倍降速和减弱动效模式下测试
  • 每个动效都已录制(scripts/filmstrip.mjs),每一帧都检查过,包括亮色、暗色和减弱动效模式
  • 对照 references/habits.md 中的每项习惯检查

文件

  • scripts/filmstrip.mjs:以 0.1 倍速将一次动效录制为帧表,每帧下方带时戳
  • references/recipes.md:36 个即用型方案的索引,每个方案在 references/recipes/ 中有一个文件,涵盖从按压和弹出框到数字滚动和流式文本
  • references/why.md:每条规则背后的原因,适用于当某个值看起来随意或有人想要打破它时
  • references/gestures.md:拖拽、滑动、面板、吸附点、动量、橡皮筋效果(手机手感:antheo-mobile)
  • references/choreography.md:多个元素作为一个变化:闭合间隙、重新排序、调整面板大小、交叉淡入
  • references/springs.md:用通俗语言解释弹簧、预设值、一个 30 行的 JS 弹簧、带降级的 linear()
  • references/performance.md:什么是廉价动画,在廉价手机上实现 60fps,如何进行分析
  • references/advanced.md:3D、滚动驱动动画、View Transitions、动效录制
  • references/vocabulary.md:从通俗描述到模式名称再到方案
  • references/motion-kit.css:生成的 motion.css 的回退副本
  • references/habits.md:生成式 UI 在这里做错的地方,每个问题都附有修复方法

相关技能