fix(motion): 站内跳转白屏——路由内容不再走 AnimatePresence wait 退场
现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。
根因:AnimatePresence mode="wait" 要求新页等旧页退场完成才挂载;App Router
导航期间的重复渲染会重置退场完成标记,切换 state 的窗口被错过,
motion.div 永久停在 exit 变体(opacity:0; translateY(-8px))。
修法:路由内容只保留 key={pathname} 的 280ms 入场;首屏仍由 mounted 渲染
裸 children;reduce 变体改为显式可见终值,避免切到空变体时冻结在半透明。
守卫:新增 client-navigation-visibility(导航后落定再读祖先链乘积);
首屏用例改逐帧采样;视觉用例改逐屏滚动触发 whileInView。
验证:E2E 20/20(四浏览器)、视觉 125/125、单测 1815、type-check/lint 0 error。
This commit is contained in:
1 parent
092ed385b0
commit
2f86c4419a
7 files changed
+167
-54
No files matched your search
@@ -896,3 +896,30 @@ if [ "$A" -eq 0 ] && [ "$B" -eq 0 ]; then git add … && git commit … && git p
|
||||
|
||||
⇒ 通用判据:**当 DOM 祖先可以整体降透明度时,「元素 opacity=1」不构成可见性证明;
|
||||
仪器必须先证明页面处于终态,再解释对比度。**
|
||||
|
||||
### 5.50 AnimatePresence mode="wait" 会让新页永久停在 exit 态(2026-10-20)
|
||||
|
||||
**现象**:生产环境所有站内跳转白屏,地址栏与标题已变,刷新(冷加载)才正常。
|
||||
**复现**:production standalone 产物,首页点「关于我们」;`main#main-content` 的父级 motion.div
|
||||
内联停在 `opacity:0; transform:translateY(-8px)`(exit 变体)且不再变化,祖先链有效 opacity 恒 0。
|
||||
|
||||
**机理**:`<AnimatePresence mode="wait">` 要等旧子树的 exit 完成才挂载新子树。App Router 导航期间
|
||||
本组件会多次重渲染,每次 `children` 引用变化都会让 AnimatePresence 重跑 diff 并把退场完成标记
|
||||
重置为 false,200ms 后切换 state 的窗口被错过。保留 `exit` 也不能只靠 sync 模式兜底:实测旧
|
||||
`main` 节点常驻(`mains: 2`),因为注销同样依赖这套 presence bookkeeping。
|
||||
|
||||
**修法**:路由内容不再包 AnimatePresence,`<motion.div key={pathname}>` 只保留入场动画
|
||||
(280ms,令牌层不变);首屏仍由 `mounted` 门控渲染裸 children。不要用「去掉 exit」或
|
||||
「mode=popLayout」折中——前者留下常驻旧子树,后者留下绝对定位的隐形残影。
|
||||
|
||||
**连带修正(同一条因果链)**:
|
||||
- 移除 presence 的 `initial={false}` 上下文后,子树恢复各自入场,屏下的 ScrollReveal 在全页截图时
|
||||
仍处 opacity:0。视觉用例的「直接跳到底」会跳过中间各屏(IntersectionObserver 只回调当前视口),
|
||||
改为**逐屏滚动**;视觉全量 125/125。
|
||||
- 首屏可见性断言改为**逐帧采样**:并行负载下,单点读 h1 会与「水合后子树重挂、入场重新开始」竞争。
|
||||
|
||||
**回归守卫**:`e2e/client-navigation-visibility.spec.ts` —— 点页脚链接后等 800ms(退场+入场落定)
|
||||
再读祖先链乘积;`E2E_TARGET=production` 下四浏览器通过。
|
||||
|
||||
⇒ 通用判据:**跨路由的「等旧页退场再挂新页」不能依赖 framer 的 presence 状态机;
|
||||
新页面挂载不得以旧页面的动画完成作为前置条件。**
|
||||
Reference in new issue
Block a user