给AI生成的前端动画加上减弱动态验收
作者要求 Agent 在新增动画或过渡的 PR 中说明如何响应 `prefers-reduced-motion`。可移除位移和布局动画,按团队规范保留短淡入,或直接切换到结束状态。
AI 深度解读
AI 给抽屉加了一个 400ms 的滑入加淡入效果,默认设置下看起来很顺。但用户在系统里开启「减少动态效果」后,抽屉仍然会滑动。作者的做法是把这件事写进 PR 要求:只要 Agent 新增动画、过渡或视图过渡,同一个 PR 就要交代减少动态效果时界面怎么变化。前端团队可以直接借用这套需求和验收写法。
用户开启「减少动态效果」后,抽屉该怎么打开?
prefers-reduced-motion: reduce 是网页读取用户动态效果偏好的方式。对抽屉来说,常见处理是去掉滑入,在团队规范允许时保留短暂的纯透明度淡入,也可以直接显示打开后的状态。作者举的例子是团队允许保留 150ms 的淡入。这个时长来自示例里的团队约定。
Agent 容易漏掉这一点,因为「让面板滑进来」已经给出了一个可演示的成功路径。教程也常从 @keyframes 或 transition: all 讲起。把减少动态效果写成验收条件后,面板能打开只是其中一项,评审还要看两种偏好下分别有哪些属性在动。
实现时优先沿用项目已有的 motion-safe:、motion-reduce、@media (prefers-reduced-motion: reduce) 或设计系统的 motion mixin。动画如果由 JavaScript 库启动,就检查 animate() 的调用路径是否也遵循同一偏好,可以通过平台的 matchMedia 读取。只审样式表容易漏掉这类入口。
写进提示词以后,PR 里验收什么?
作者给了一段可以放进 Agent 任务描述的提示词,把实现、复用和 PR 说明放在一起。
If you add a transition, animation, or view transition, include a prefers-reduced-motion path in the same PR.
Use the existing motion helper in src/styles/motion.css.
Do not use transition: all.
In the PR body, say what still moves (if anything) when reduced motion is on.
最后一行要求写出可核对的结果,比如「复用现有 helper,开启减少动态效果后抽屉立即展开」。第二行的 src/styles/motion.css 是示例路径,落地时应指向自己仓库里的实际文件。团队已有动态效果文档或时长 token 时,也可以直接让 Agent 读取。
评审时可以沿着动画的触发点检查。新增 transform 动画有没有对应分支?transition: all 300ms 会覆盖哪些属性?JavaScript 调用有没有读取对应偏好?如果团队已经用 Storybook 或 Playwright 测其他无障碍状态,可以加一个启用 prefers-reduced-motion: reduce 的用例。默认设置下的截图只覆盖默认路径。
页面切换和自动轮播也要一起检查
使用 document.startViewTransition 或设置 view-transition-name 来做视图过渡与共享元素动画时,作者建议在减少动态效果模式下跳过过渡,直接切换页面状态。采用 CSS View Transitions API 后,仍要明确处理这条路径。
还有些动效会自己启动,比如轮播自动播放、骨架屏闪动、无限滚动的品牌标志。用户开启减少动态效果后,这些效果也需要停下来。审查范围如果只看点击按钮后发生的变化,就容易漏掉它们。
我的判断
这篇最有用的地方是把「支持减少动态效果」变成了可评审的问题:用户开启偏好后,还有什么在动?只写进 Agent 提示词,约束容易散落在各次任务里。只依赖现有 CSS 工具类,覆盖范围又取决于 JavaScript 动画和视图切换是否也接入了同一套规则。已有设计系统的团队可以把默认行为放在共用组件里,再用 PR 说明处理新增动效和例外。
作者分享的是自己的评审经验,没有给出采用规则前后的遗漏率,也没有对照不同测试方案。150ms 淡入能否保留,要看团队约定。原文也没有交代系统偏好在页面打开后发生变化时应怎样处理。
能拿来做什么
- 让 Agent 给抽屉或面板加动效时,在任务描述里给出仓库现有 helper 的路径,并要求 PR 写明开启减少动态效果后界面会怎样展开。
- 审查新增动效时,从 CSS 过渡、JavaScript
animate()和document.startViewTransition分别追到触发点,确认对应路径遵循同一用户偏好。 - 如果项目已有 Storybook 或 Playwright 无障碍用例,给新动效补一个减少动态效果场景,验证抽屉能直接到达打开状态,或只保留团队允许的淡入。