feat: add scroll top mask, unify page top spacing and docs

This commit is contained in:
2026-08-08 03:57:47 +08:00
parent 38045073b0
commit a3c3005c04
73 changed files with 1350 additions and 169 deletions
@@ -0,0 +1,32 @@
# D 类 - 工具/文字页通用规范
## 页面列表
| 页面 | 路由 |
|---|---|
| 联系客服 | `pages/service/index` |
| 定制协议 | `pages/agreement/index` |
| 用户数据库 | `pages/userDatabase/index` |
## 组件调用
- **TabBar**:不显示。
- **TopMask**:调用;是否开启 `showBack` 按页面能力决定:
- 联系客服:本期补齐返回能力 → `showBack`
- 定制协议 / 用户数据库:无返回入口 → `showBack={false}`
- **useStatusBar / ThemedPageMeta**:按现有页面模式保留。
## 设计规范
- 顶部字距:`paddingTop(或 marginTop= statusBarHeight + 12px`
- 工具/文字页内容通常较短:TopMask 仍随滚动淡入,但触发阈值由 `targetSelector` 决定。
- 底部:避让手势条 `env(safe-area-inset-bottom)`
- 文字页(协议)保证长文本阅读舒适,行距/字号遵循现有样式。
## 验收清单
- [ ] 顶部字距为 `statusBarHeight + 12px`
- [ ] 有返回能力的页面(联系客服)存在返回入口,TopMask 显示返回按钮
- [ ] 无返回能力的页面不显示返回按钮
- [ ] 滚动时 TopMask 正常淡入