diff --git a/README.md b/README.md index e241725..2e1a841 100644 --- a/README.md +++ b/README.md @@ -93,8 +93,10 @@ - 顶栏(`top-nav`)与打包页顶栏(`.mode-topbar`)的水平内边距也用 `var(--wms-page-pad)`,保证 logo/内容左右对齐。 - **主体内左右分栏间距统一 `--wms-panel-gap` = `0.15rem`(15px)**: 订单 `.panel-left { margin-right }`、退件 `.rp-left { margin-right }`、打包 `.pack-right { margin-left }`(三页统一用 `margin`,保持一致)。 - > 更正(2026-09-26):此前记的“真机 WebView 不支持 flex `gap`,写了会贴在一起”**不成立** —— 用户实测 `gap` 在真机生效(原因见第 13 节)。 - > 所以页面里现存的 `gap` **保留即可**,不必再逐处换成 `margin`;新代码用 `gap` 或 `margin` 都行,只是同一处不要两种混用。 + > **更正(2026-10-27)**:2026-09-26 记的“`gap` 在真机生效”**是错的**。真机 `webview_provider` = `com.android.webview`, + > `versionName = 52.0.2743.100`(Chromium 52),flex `gap` 要 Chrome 84+ 才有 → **真机上 `gap` 完全失效** + > (退件页曾用 `gap: 0.15rem` 分隔两张卡片,像素级采样量到空隙为 **0**)。 + > 结论:**间距一律用 `margin`**;页面里现存的 `gap` 要逐步换成 `margin`(同一处只能留一种)。 - 页面骨架统一用 `.page` / `.page-main`,每页只写差异项。 - **侧栏内容用「灰底 + 白卡片」**:侧栏自己不要铺底色(订单左栏、退件左栏都是透明灰底,与右栏一致);里面的每一块(搜索、列表、底部信息栏)做成独立白卡片,卡片间距 `0.15rem`、卡片内边距 `0.15rem`。 - 滚动方式各页自定:整块滚用 `overflow-y: auto`(订单、称重);面板各自滚用 `overflow: hidden` + 子面板 `auto`(退件)。 @@ -171,12 +173,11 @@ npm run lint:layout # 代码级自检:字号/圆角/间距网格/rem 小数 ### 13. 真机平台注意(WebView 由 Chrome 应用提供) -> **更正(2026-09-26)**:此前记录的“真机 WebView = Chromium 52、不支持 flex `gap`”**已被实测推翻** —— 用户确认 `gap` 在真机生效。 -> 原因:真机的 WebView 提供者是 **Chrome 应用**(`adb shell settings get global webview_provider` = `com.android.chrome`), -> 不是随固件的系统 `com.android.webview`;版本跟设备上装的 Chrome 走,**不能用“Android 7.1.2 ⇒ Chromium 52”推断能力边界**。 -> 复核版本:`adb shell dumpsys webviewupdate`(顺手 `adb shell dumpsys package com.android.chrome | findstr versionName`)。 -> ⚠️ 该固件 WebView 实现就是 Chrome,**不能卸载 Chrome/系统 webview**(卸了页面直接白屏)。 -> 教训:**能力边界要实测或查版本,不要从系统版本号推**。 +> **更正(2026-10-27)**:2026-09-26 那条“`gap` 在真机生效 / WebView 由 Chrome 应用提供”的结论**已作废**。 +> 实测 `adb shell settings get global webview_provider` = `com.android.webview`, +> `adb shell dumpsys package com.android.webview | findstr versionName` = **52.0.2743.100(Chromium 52)**, +> 所以 **flex `gap`(Chrome 84+)不支持**:退件页 `gap: 0.15rem` 的两张卡片,按列采样像素量到的空隙是 0。 +> 验证手法:`adb exec-out screencap -p > shot.png` 后用 `build/measure.ps1`(按列/行采样像素)量真实间距,比肉眼看截图可靠。 **与 WebView 版本无关的硬约束(务必遵守)** @@ -190,7 +191,7 @@ npm run lint:layout # 代码级自检:字号/圆角/间距网格/rem 小数 **新 API / 新语法:先确认再用(不要照抄旧结论)** - 历史上为“老 WebView”规避过:flex `gap`、`replaceChildren`、`Element.append/prepend/before/after`、CSS `min()/max()/clamp()`、CSS Grid、无前缀 `position: sticky`。 - 其中 **`gap` 已实测可用**;其余**没有实测过是否必需**,属于保守写法: + 其中 **`gap` 已实测不可用**(Chromium 52),间距必须用 `margin`;其余**没有实测过是否必需**,属于保守写法: - 视图层 renderjs 保持 ES5 写法(少一层降级不确定性); - `position: sticky` 同时写 `-webkit-sticky`(老 WebView 只认前缀;新 Chrome 前缀仍有效、无副作用); - 换 DOM 节点用 `appendChild` / `removeChild` 就够,没必要引入新 API。 @@ -230,6 +231,11 @@ npm run lint:layout # 代码级自检:字号/圆角/间距网格/rem 小数 - 工具类:`.scan-hidden-input`(隐藏的扫码输入框,四页共用;打包页只覆盖 `top: 0`) - 按钮去默认边框的 `::after`:目前 12 个类集中写在 base.css 的选择器列表里, **新增自定义 `uni-button` 按钮必须把类名补进这个列表**,否则会带上框架默认的 `1px solid rgba(0,0,0,.2)` 边框。 +- **按钮颜色被框架内置样式覆盖(2026-10-27 踩坑)**:真机 APP-PLUS 的 `