Neo-ZQYY/docs/prd/Neo_Specs/review-audit/P6-NS1-16.md

P6→NS1/RNS1 缺失项 #16：页面切换时的转场动画规范

简要结论

• 状态：❌ 未解决
• 风险等级：🟡 低
• 无自定义转场动画配置，完全依赖微信小程序默认的页面切换动画。router.ts 仅封装了 wx.navigateTo/switchTab/navigateBack，无动画参数。

详细审查

审查范围

• apps/miniprogram/miniprogram/utils/router.ts
• apps/miniprogram/miniprogram/app.json（window 配置）
• apps/miniprogram/miniprogram/pages/task-list/task-list.ts（页面跳转调用）
• apps/miniprogram/miniprogram/pages/task-detail/task-detail.ts（页面跳转调用）

发现

1. router.ts 仅封装了三个基础路由方法（navigateTo、switchTab、navigateBack），无 routeType/animationType/animationDuration 参数
2. app.json 的 window 配置仅设置了导航栏样式，无 pageOrientation、animationType 等动画配置
3. 页面跳转直接调用 wx.navigateTo({ url: ... })，未使用 routeType 参数
4. 无页面进入/退出的自定义 CSS 动画
5. 无 wx.navigateTo 的 routeType 参数（微信基础库 2.29.2+ 支持）

证据

router.ts 完整内容（无动画配置）：

export function navigateTo(url: string): void {
  wx.navigateTo({ url })
}
export function switchTab(url: string): void {
  wx.switchTab({ url })
}
export function navigateBack(delta: number = 1): void {
  wx.navigateBack({ delta })
}

app.json window 配置（无动画相关字段）：

"window": {
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "球房运营助手",
  "navigationBarBackgroundColor": "#ffffff"
}

task-list.ts 中直接调用 wx.navigateTo：

wx.navigateTo({
  url: `${DETAIL_ROUTE}?id=${id}`,
  fail: () => wx.showToast({ title: '页面跳转失败', icon: 'none' }),
})

建议

1. 微信小程序默认转场动画（从右滑入/滑出）已满足基本体验，此项优先级较低
2. 如需自定义，可在 router.ts 的 navigateTo 中添加 routeType 参数（需基础库 2.29.2+）
3. 可选方案：页面 onLoad 时添加入场 CSS 动画（opacity + translateY 渐入），提升视觉流畅感
4. 建议作为 P13（前端打磨）的后续迭代项