修复运动性能
修复动画性能问题。
如何使用
-
/fixing-motion-performance将以下规则应用于本会话中的所有 UI 动画工作。 -
/fixing-motion-performance <文件>对照以下所有规则审查该文件,并报告:- 违规项(引用确切的代码行或片段)
- 违规原因(一句话说明)
- 具体修复方案(代码级别的建议)
除非明确要求,否则不要迁移动画库。在现有技术栈内应用规则。
何时应用
在以下情况下参考这些指南:
- 添加或修改 UI 动画(CSS、WAAPI、Motion、rAF、GSAP)
- 重构卡顿的交互或过渡
- 实现滚动驱动动画或滚动展示效果
- 对布局、滤镜、遮罩、渐变或 CSS 变量进行动画
- 审查使用了
will-change、transform或测量的组件
渲染步骤术语表
- 合成层:
transform、opacity - 绘制:颜色、边框、渐变、遮罩、图片、滤镜
- 布局:尺寸、位置、流式布局、网格、弹性布局
规则分类(按优先级)
| 优先级 | 分类 | 影响 |
|---|---|---|
| 1 | 禁止模式 | 严重 |
| 2 | 选择合适的动画机制 | 严重 |
| 3 | 测量 | 高 |
| 4 | 滚动 | 高 |
| 5 | 绘制 | 中高 |
| 6 | 图层 | 中 |
| 7 | 模糊与滤镜 | 中 |
| 8 | 视图过渡 | 低 |
| 9 | 工具边界 | 严重 |
快速参考
1. 禁止模式(严重)
- 不要在同一个帧内交错执行布局读取和写入操作
- 不要在较大或重要的表面上连续进行布局动画
- 不要通过
scrollTop、scrollY或scroll事件驱动动画 - 不允许没有停止条件的
requestAnimationFrame循环 - 不要混合使用多个各自测量或改变布局的动画系统
2. 选择合适的动画机制(严重)
- 默认使用
transform和opacity进行动画 - 仅当交互需要时才使用 JS 驱动的动画
- 绘制或布局动画只允许在小型、隔离的表面上使用
- 一次性效果比持续运动更可接受
- 优先选择降级技术而不是完全移除动画
3. 测量(高)
- 只测量一次,然后通过
transform或opacity进行动画 - 在写入之前批量完成所有 DOM 读取
- 不要在动画过程中反复读取布局信息
- 对于布局类效果,优先选择 FLIP 风格的过渡
- 优先采用能够批量处理测量和写入的方法
4. 滚动(高)
- 对于滚动驱动的动画,优先使用 Scroll 或 View Timelines(如果可用)
- 使用 IntersectionObserver 控制可见性和暂停
- 不要轮询滚动位置来进行动画
- 当元素离开屏幕时暂停或停止动画
- 滚动驱动动画不得在大型表面上触发连续的布局或绘制
5. 绘制(中高)
- 触发绘制的动画只允许在小型、隔离的元素上使用
- 不要在大型容器上对绘制密集型属性进行动画
- 不要对
transform、opacity或position的 CSS 变量进行动画 - 不要对继承的 CSS 变量进行动画
- 将动画 CSS 变量局部化并避免继承
6. 图层(中)
- 合成器动画需要提升为图层,切勿假定已提升
- 临时且精确地使用
will-change - 避免创建过多或过大的提升图层
- 当性能关键时,用工具验证图层行为
7. 模糊与滤镜(中)
- 保持模糊动画的范围较小(<=8px)
- 仅将模糊用于短时的一次性效果
- 切勿连续对模糊进行动画
- 切勿在大型表面对模糊进行动画
- 在模糊之前优先使用
opacity和translate
8. 视图过渡(低)
- 仅将视图过渡用于导航级别的更改
- 避免对交互密集的 UI 使用视图过渡
- 当需要中断或取消时避免使用视图过渡
- 将尺寸变化视为可能触发布局的操作
9. 工具边界(严重)
- 除非明确要求,否则不要迁移或重写动画库
- 在现有的动画系统内应用这些规则
- 切勿在同一个组件中部分迁移 API 或混合使用不同风格
常见修复方案
/* 布局抖动:用 transform 动画替代 width 动画 */
/* 之前 */ .panel { transition: width 0.3s; }
/* 之后 */ .panel { transition: transform 0.3s; }
/* 滚动驱动:使用 scroll-timeline 替代 JS */
/* 之前 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 之后 */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// 测量:先批量读取再写入(FLIP 方法)
// 之前 — 布局抖动
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 之后 — 只测量一次,通过 transform 进行动画
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
审查指南
- 优先执行严重规则(禁止模式、工具边界)
- 选择与意图匹配的最小渲染代价方案
- 对于任何非默认选择,说明其理由(元素尺寸、时长或交互需求)
- 审查时,优先提供可操作的建议和具体替代方案,而非理论解释