Motion 是一个面向界面动效的技能规范,规定屏幕上动效的统一做法,涵盖什么该动、曲线与时长、手势、退场、动态模糊和减少动态效果。其内容以“规则—反例—替代写法”成对的形式组织,并配套分级上报格式。
一、时长与曲线 项目已有动效令牌时优先复用;没有时使用本规范给出的精确值。用户触发且运行超过 300ms 的动效在任何风格下都算问题。悬停颜色变化即时生效、不加过渡;按压与悬停位移动画 120–180ms;小的状态变化 180–260ms;用户触发的动效不超过 300ms,整块面板或抽屉最多 400ms。模式为 wait 时,退场与入场串行播放,各自时长减半;觉得动效慢时,优先缩短时长而不是改曲线。内置 ease-out 关键字偏弱,入场和退场使用 cubic-bezier(0.23, 1, 0.32, 1),屏幕上的移动使用 cubic-bezier(0.77, 0, 0.175, 1)。关闭比打开更快,关闭和悬停移出都不延迟。
二、该动与不该动 页面切换、面板和加载态只用透明度淡入淡出,不使用滑动或缩放,并且只对实际变化的轴做动画。页面切换不重播入场:路由级 AnimatePresence 设 initial={false},包裹状态切换的同样设置;缓存视图直接渲染,不淡入也不闪骨架屏。过渡要写明动画属性(通常为 opacity 和 transform),禁止 transition: all。交互状态切换使用过渡或弹簧,便于用户反向操作时重定向;关键帧留给只运行一次的序列。
三、入场与原点 入场从 scale(0.95) 及以上配合 opacity: 0 开始,不得从 scale(0) 生长。下拉或浮层以触发元素为变换原点缩放;模态框没有锚点,保持居中。
四、手势 拖拽、滑动等用户可中途反向的动作使用弹簧,释放时把指针速度传入。滑动关闭看距离或速度,约 0.11 px/ms 以上的快速轻扫即可关闭。拖过边界时阻力逐渐增大,而不是硬停。拖拽开始时捕获指针,并忽略多余触点。每个拖拽、滑动或捏合都要有点击和键盘替代方式。
五、图标与文字 图标原地切换(如复制变为已复制)时交叉淡化:缩放 0.25→1、透明度 0→1、模糊 4px→0。两个 morph 形态的图标改用路径 d 动画(在移动曲线上按小状态变化处理),减少动态效果时改为交叉淡化。交叉淡化仍像两个物体时,过程中加 filter: blur(2px) 作为桥接,模糊控制在 20px 以内。
六、动态模糊 动态模糊只用于眼睛无法追踪的对象:甩出的卡片、关闭的抽屉、快速归位的面板或加载指示器;滚动、轮播翻页、列表滑入和正在阅读的文字不加模糊。使用 @web-kits/motion-blur,React 中用 useMotionBlur,其他环境用 motionBlur(element)。默认值为 180° 快门、Echo 每 1.5px 一份最多 16 份、smear 上限 1.05。ref 要放在运动的元素本身;宿主第一个子元素是绘制层,背景、边框、阴影应放在该层或层内;绘制层本身不带 transform。曲线运动用手工路径时每帧调用 blur.render(previous, current);慢放演示需按比例提高快门(如 1/4 速用 shutter: 720)。自定义技术须在 clear 和 destroy 中清除全部样式,并在渲染中设置 key。
七、减少动态效果 当 prefers-reduced-motion: reduce 匹配时,滑动、缩放和模糊改为透明度交叉淡化;动态模糊关闭拖影,reducedMotion 保持默认 "user"。
八、其它细节 按压缩放至 0.98,形变保持在 0.95–1.05;列表逐项错开小于 50ms,一次性分段入场错开 100ms,常规交互不使用错开且不得阻塞输入。带退场的条件元素须放在按稳定 id 设键的 AnimatePresence 内,并退场回初始值;组件库对话框保持挂载、切换 open 属性。容器宽高动画用 ResizeObserver 测量内部元素、动画外层元素;折叠时内容保持原来的打开宽度,避免中途重排。
九、上报方式 一个根因一条发现,格式为 file:line - [rule-id] 问题描述,再给出 Rule | Count | Severity 汇总。HIGH 指破坏使用或可访问性(退场不播放、容器测量自身、手势无按钮、阅读文字上有模糊、squeeze 或 svg 图层含两个子元素等);MEDIUM 包括页面滑动、入场重播、固定曲线手势、超过 300ms、输入时动效、曲线错误、transition: all、切换状态用关键帧、忽略减少动态效果、条件渲染对话框、折叠时内容重排、scale(0) 入场、忽略轻扫关闭、手写模糊、ref 放错、不透明白底宿主、绘制层带 transform、非 Echo 的旋转模糊、smear 超限、reducedMotion: "never" 等;LOW 包括悬停淡色、按压缩放过重、错开过长、原点错误、关闭不快于打开、提示延迟过长、图标硬切换、裸 ease-out、交叉淡化无模糊、边界无阻力、曲线用了两个变换、慢放演示仍用全速快门、自定义技术残留样式或重复重建等。存在 HIGH 时阻止合并,否则通过;未读过的文件不得通过;依赖时序的检查要实际播放,依赖拖影的检查要冻结在最快点;未能执行的检查标注为未验证。