2 Commits
Author SHA1 Message Date
zhangxiang 2f86c4419a 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。
2026-10-20 14:00:41 +08:00
zhangxiang ca3df3221d fix(motion): 冷首访白屏——JS 就绪前强制入场元素可见,水合后再交还 framer
用户反馈「首次访问白屏,需要刷新才可以」。用禁用缓存 + 限速复现并量化:
745ms 时 SSR HTML 已在(正文 1177 字),但 h1 的 opacity 仍为 0;
直到 5945ms 才变 1 ⇒ 冷首访/弱网下 3–5 秒白屏,刷新后脚本已在缓存里所以「刷新就好」。

根因是全站性的:167 处 framer 入场把初始 opacity 内联成 0
(SSR 实测 style="opacity:0;transform:translateY(30px)"),而它只能由 JS 驱动;
页面级 template 的 initial 也是 {opacity:0,y:8}。逐文件改既大又有误伤风险
(面板/轮播的 opacity 是状态语义,不是入场)。

修法(一处兜底 + 一处交接,失败也是敞开的):
- globals.css 新增规则:当 html 上没有 data-content-ready 时,
  把内联 opacity:0 的入场元素强制为 1(同时匹配 "opacity:0" 与 "opacity: 0" 两种写法)。
  JS 尚未执行时内容可见;若脚本永远失败,则永不置位,内容一直可见。
- 营销页 template:水合后 800ms(> 最长入场 280ms + 余量)置位 data-content-ready,
  把控制权交还 framer,避免「闪一下」。

回归守卫 e2e/first-paint-visibility.spec.ts:
① 禁用 JS 时 h1 内联仍 opacity:0 但计算值为 1(兜底生效,且证明前提仍在);
② 正常加载时 data-content-ready 置位、交接前后 h1 均为 1。
变异验证:删掉 CSS 规则 ⇒ 2 条全红;恢复 ⇒ 2 条绿。
复算:tsc / type-check:e2e 0、check:visual 0、视觉 chromium-desktop 25/25、reduce 回归 2 绿。
2026-10-20 08:16:06 +08:00