v0.3.0 沉浸式按 SyncCalendar 重做(通知栏与页面完全同色)+ 个人信息卡改白块
## ① 沉浸式:改用本机 SyncCalendar 的方案(用户指定参考) 用户原话:「上面那一块的颜色和通知栏的颜色完全融为一体; 紧接着就是应用图标和标题,尽量靠上」。 三件套(缺一不可): 1. 系统栏涂**全透明** `#00000000`; 2. `setWindowBackgroundColor(页面底色)` 供透明系统栏透出; 3. **紧邻系统栏的元素不设自己的背景色** + 根容器 `expandSafeArea`。 🔴 第三件是最关键、也是我先前漏掉的一环: 我原来给顶栏设了白色 `backgroundColor`,于是状态栏(透出纸色)与顶栏(白) 仍上下拼接。读 SyncCalendar 源码发现它的 `header()` **根本没有 backgroundColor** —— 这才是"融为一体"的真正机制。已在代码里写明原因,防止回退。 配套简化:删掉自己算安全区的那套(`statusBarH`/`bottomBarH`/ `loadWindowInsets`/`applyAvoidAreas`,共约 110 行)—— 不再手算,也就不会算错。 ## ② 顶栏改「图标 + 标题」 按用户要求:应用图标 + 「家书」标题(下行小字显示当前模块)贴左上, 右侧铃铛与头像。顶栏高度 56 → 48vp,上下内边距压到 4,内容整体上移。 ## ③ 个人信息卡恢复为白色卡片 用户明确要求("还是得用一个白色的块,这样显得好看")。 曾一度做成"不套卡片的头部"(理由是省首屏高度),现按用户观感改回白卡。 ⚠️ 与顶栏的区别:顶栏**不能**有背景色(否则与状态栏割裂), 而这张卡在顶栏下方、与状态栏不相邻,套白卡没有这个问题。 ## 验证(全部基于真机) 逐行像素采样(`_tooling/familybook_immersion_check.py`, 模型读不了图 ⇒ 用数字裁定,不靠目测): · `y=0..271` 全为 `#F7F3EA` ⇒ **状态栏与顶栏同色,融为一体** ✓ · 底部 `y=2224..2444` 为纸色,无异常条 ✓ 真机界面遍历(`_tooling/familybook_harmonyos_probe.py`): · A 组抽屉 11 个模块 **11/11** · B 组家谱 **1/1**;C 组通知/设置 **2/2** · D 组深验(特征文本)**12/12** 合计 **14 个页面全通过**。 ⚠️ 顺带修掉探针自身两个坑(都记进注释了): · `nodes_of` 原来只收集**有文字**的节点 ⇒ 找不到纯图标的汉堡按钮, 导致"抽屉打不开"、10 个模块连锁失败(看着像应用坏了,其实是探针瞎了); · 汉堡按钮坐标写死 ⇒ 顶栏变矮后点空。改为在界面树里动态探测、 并**排除系统状态栏区域**(那里也有可点击元素,曾误取到 (103,56))。 ## 编译 0 error(保留 1 条 `setWindowBackgroundColor` 的 unavailable 告警,它是透明方案的必需组成)
This commit is contained in:
@@ -15,7 +15,7 @@
|
||||
| 已完成 | 说明 |
|
||||
| --- | --- |
|
||||
| 工程骨架 | Stage 模型 + ArkTS / ArkUI,targetSdk 26.0.0 / compatibleSdk 6.1.1(24) |
|
||||
| 沉浸式 | 窗口铺满整屏,状态栏与顶栏同色融为一体、底部手势条与页面同色 |
|
||||
| 沉浸式 | 照本机 SyncCalendar 的方案:系统栏全透明 + 根容器 `expandSafeArea`,通知栏与页面**完全同色** |
|
||||
| 左侧抽屉 | 宽屏常驻侧栏 / 窄屏滑出层,两套形态同一组件 |
|
||||
| 12 个模块页面 | 首页、名册、观影、旅程、日程、资源、任务、纪念日、财务、读书、笔记(+ 家谱) |
|
||||
| 附加页面 | 通知消息、个人设置 |
|
||||
@@ -88,6 +88,40 @@ entry/src/main/ets/
|
||||
|
||||
## 设计说明
|
||||
|
||||
### 沉浸式(三件套,缺一不可)
|
||||
|
||||
参考本机另一个应用 **SyncCalendar**(用户指定)的做法:
|
||||
|
||||
1. **系统栏涂成全透明** —— `statusBarColor: '#00000000'`、`navigationBarColor: '#00000000'`;
|
||||
2. **窗口底色 = 页面底色** —— `win.setWindowBackgroundColor(pageBg)`,供透明系统栏透出;
|
||||
3. **紧邻系统栏的元素不设自己的背景色** —— 顶栏**不能**有 `backgroundColor`,
|
||||
让它透出根容器底色;根容器再 `expandSafeArea([SYSTEM], [TOP, BOTTOM])`
|
||||
把背景铺到状态栏区域。
|
||||
|
||||
原理:透明系统栏透出的是**窗口底色**,而顶栏也透出**同一个**底色 ⇒ 天然同色、
|
||||
「通知栏与上方完全融为一体」。内容仍在安全区内,**不需要手算状态栏高度**。
|
||||
|
||||
⚠️ 常见的两个坑(都踩过):
|
||||
- 调 `setWindowLayoutFullScreen(true)` 后子组件会钻到状态栏底下,页面得自己让位,
|
||||
极易算错(曾出现顶部重复避让 156px);
|
||||
- 给状态栏或顶栏**写死颜色**必然与相邻层割裂(曾出现「米色状态栏 + 白色顶栏」的拼接感)。
|
||||
|
||||
验证方式:**逐行像素采样**(`_tooling/familybook_immersion_check.py`)。
|
||||
判据是「状态栏区颜色 == 顶栏区颜色」,用数字裁定而不是目测 ——
|
||||
最终实测 `y=0..271` 全为 `#F7F3EA`(纸色),达标。
|
||||
|
||||
Web 端顶栏是一排横向模块入口,最多放 12 个模块 —— 手机宽度下必然溢出。
|
||||
改成左侧抽屉后,竖向排列不受数量限制,还能顺带放下「模块说明 + 主题色」
|
||||
这层信息,一眼看清每个模块是干什么的。
|
||||
|
||||
抽屉有**两套形态**,由窗口短边决定(≥ 600vp 为宽屏):
|
||||
|
||||
- **宽屏**(平板 / 折叠屏展开 / 横屏手机):抽屉常驻,与内容并排;
|
||||
- **窄屏**:内容铺满,抽屉从左侧滑出,点遮罩或选中模块即收起。
|
||||
|
||||
判据用「短边」而不是「宽度」—— 短边在旋转时不变,所以比例接近 1:1 的设备
|
||||
横竖屏布局保持一致。
|
||||
|
||||
### 为什么是抽屉
|
||||
|
||||
Web 端顶栏是一排横向模块入口,最多放 12 个模块 —— 手机宽度下必然溢出。
|
||||
|
||||
Reference in New Issue
Block a user