Antheo Motion
动效是关于变化的信息:某物到达、离开、移动或回应了你。不解释任何东西的动效是噪音;没有动效的变化则是跳跃。此技能决定哪些变化需要移动,并为每个变化赋予精确的时长。组件的标志性瞬间属于 antheo-moment;时长令牌由 antheo-tokens 生成;减弱动效需求由 antheo-access 检查。审计、删减或规划整个应用的动效是 antheo-motion-audit 的职责。
按此顺序决定
- 列出屏幕上的每一个变化:什么打开、关闭、出现、离开、重新排序、更新、加载、成功或失败。
- 标记人们看到每个变化的频率:每天多次、每天一次、或很少。
- 为每个变化赋予下表中的时长和缓动。
- 将那个罕见的、有意义的事件(如果有的话)交给 antheo-moment。
- 快速检查两次,并使用减弱动效模式,然后录制它并读取帧(见下文)。
命名移动的原因,否则不要移动
“这个移动,是为了让用户理解___。” 如果无法完成这个句子:不要动画。
看到越频繁,移动越少
| 频率 | 规则 |
|---|---|
| 每天多次(打字、行、标签、菜单、调色板) | 最多 150ms,移动 4px;从键盘触发时,只做短暂的淡入淡出 |
| 每天一次(对话框、面板、提示框、保存) | 短暂的进入和更快的退出,150 到 300ms |
| 很少(首次成功、已下订单) | 标志性瞬间的唯一位置(antheo-moment) |
时长,按场景
| 令牌 | 值 | 适用场景 |
|---|---|---|
--dur-instant | 100ms | 颜色和不透明度反馈 |
--dur-fast | 150ms | 按压、悬停进入和离开、菜单或工具提示打开 |
--dur-base | 200ms | 元素离开、对话框关闭、值或文本切换、提示框进入 |
--dur-open | 250ms | 对话框打开、标签、手风琴、卡片调整大小 |
--dur-slow | 300ms | 面板或抽屉升起、标记滑动 |
--dur-page | 400ms | 页面或共享元素过渡 |
界面动效保持在 300ms 或以下;页面移动保持在 400ms 或以下。加载器、进度条和滚动相关的动效使用 linear。
开与关,成对出现
| 元素 | 打开 | 关闭 |
|---|---|---|
| 菜单、弹出框、选择框 | 150ms,从 scale(0.97) 和淡入开始,以触发器为原点 | 120ms |
| 工具提示 | 400ms 延迟,然后 150ms 淡入;如果在前一个关闭后的 300ms 内触发,则立即显示 | 立即 |
| 对话框 | 250ms:上升 8px,淡入,从 scale(0.96) 缩放 | 200ms |
| 面板、抽屉 | 300ms,从边缘进入,全程完全不透明(无淡出,无模糊) | 200ms |
| 提示框 | 200ms,上升 12px | 200ms,按原路返回 |
| 手风琴、高度展开 | 250ms,grid-template-rows: 0fr 到 1fr | 200ms |
永远不要延迟关闭或悬停离开:而是缩短持续时间。
进入和离开使用同一个曲线
--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)。
在整个应用范围内
- 查找: 列出每个变化、其查看频率、当前如何移动、应该怎样移动的表格。
- 改进: 为每个数值使用令牌,补全缺失的退出动画,将变换原点设置在触发器处,一次一个模式。
- 移除: 任何在每次加载时都动画、在每天多次的操作上播放、延迟下一个操作、在用户阅读时循环、或在常规操作上运行超过 300ms 的动效。不确定时,移除之。
- 批准或驳回: 一个解释原因的句子,仅使用令牌,仅允许使用的属性,退出比进入更快,处理了减弱动效,在正常速度和 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 在这里做错的地方,每个问题都附有修复方法