Files
novalon-website/docs
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00
..
2026-03-10 12:45:08 +08:00

Novalon Website 文档

欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。

文档导航

📚 架构文档

💻 开发文档

🚀 部署文档

🧪 测试文档

🔌 API文档

📖 使用指南

项目概述

Novalon Website是四川睿新致远科技有限公司的企业官网,采用现代化的技术栈构建。

技术栈

  • 框架: Next.js 16 + React 19
  • 语言: TypeScript
  • 样式: Tailwind CSS
  • 数据库: SQLite + Drizzle ORM
  • 认证: NextAuth.js
  • 测试: Playwright + Jest

核心功能

  • 企业展示和产品服务介绍
  • 成功案例和新闻动态
  • 在线咨询和联系表单
  • CMS内容管理后台
  • 响应式设计和SEO优化

快速链接

贡献指南

文档更新

  1. 确保文档内容准确、清晰
  2. 使用Markdown格式编写
  3. 添加必要的代码示例
  4. 更新相关链接和引用

文档审查

  • 技术准确性
  • 内容完整性
  • 格式规范性
  • 链接有效性

获取帮助

如果在使用过程中遇到问题,可以:

  1. 查看相关文档
  2. 搜索故障排查指南
  3. 联系开发团队

文档版本

  • 版本: 1.0.0
  • 更新日期: 2026-03-24
  • 维护者: 开发团队

© 2026 四川睿新致远科技有限公司