From c5c543ba43b708c1882f8d89f39a14af6d4d0c28 Mon Sep 17 00:00:00 2001 From: AskaEth Date: Mon, 2 Nov 2026 02:04:32 +0800 Subject: [PATCH] =?UTF-8?q?docs(app-iced):=20=E5=BF=85=E4=BF=AE3=20504?= =?UTF-8?q?=E2=86=92435=20=E4=B8=80=E8=BD=AE=E7=95=99=E4=B8=8B=E7=9A=84?= =?UTF-8?q?=E4=B8=89=E5=A4=84=E6=96=87=E6=A1=A3=E6=BC=82=E7=A7=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 视觉 r2 逐条点出来的三处「偏离登记与对外口径没跟着改」： 1. `pages/mod.rs` 偏离 #1：详情列右缘写 976 / 分歧 180px —— 行宽收到 424 后实测是 页头右缘 **1156**、详情列右缘 **896**（472 + 424），分歧 **260px**； 2. `pages/mod.rs` 偏离 #3：单列页占比写 48%（435/1044）—— 现在是 **40.6%（424/1044）**； 3. `frame/pieces.rs` 的 `scroll_style` 函数头仍写「滑块 `Outline`、尺寸取 iced 默认」—— 实现早已是 `OutlineVariant` + 6px 轨 + 2px 内缩，文档跟上。 三处都在 D30 要求「逐条写清」的偏离登记/口径里，属于对外承诺，不是内部注释。 --- crates/app-iced/src/pages/frame/pieces.rs | 3 ++- crates/app-iced/src/pages/mod.rs | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/crates/app-iced/src/pages/frame/pieces.rs b/crates/app-iced/src/pages/frame/pieces.rs index c00edca..aac04a8 100644 --- a/crates/app-iced/src/pages/frame/pieces.rs +++ b/crates/app-iced/src/pages/frame/pieces.rs @@ -267,7 +267,8 @@ pub fn filled(color: Color) -> container::Style { } } -/// 滚动条配色（令牌角色）：轨道透明，滑块 `Outline`，尺寸取 iced 默认。 +/// 滚动条配色（令牌角色）：轨道透明、滑块 `OutlineVariant`（低对比，弱于正文）， +/// 轨宽 `SCROLLBAR_WIDTH`（6px）+ `SCROLLBAR_MARGIN`（2px 内缩）——视觉 r1 P2-2 的修法。 /// /// 只在**独立滚动区**上挂（实例页列表列），不许挂到整页上——整页滚动会把页头一起滚走。 pub fn scroll_style(ui: &Ui) -> impl Fn(&IcedTheme, scrollable::Status) -> scrollable::Style + '_ { diff --git a/crates/app-iced/src/pages/mod.rs b/crates/app-iced/src/pages/mod.rs index 2925e87..2099dc8 100644 --- a/crates/app-iced/src/pages/mod.rs +++ b/crates/app-iced/src/pages/mod.rs @@ -42,9 +42,9 @@ //! //! | # | 偏离 | 为什么 | 什么时候收口 | //! |---|---|---|---| -//! | 1 | 页头按 M3 口径**铺满页面宽度**（贴页边距），不与正文列对齐 | AppBar 本来就该满宽；1180 下页头右缘 1156 与详情列右缘 976 有 **180px 分歧** | 真 top bar 落地时按 M3 定语（页头右侧是操作区，不跟随列宽） | +//! | 1 | 页头按 M3 口径**铺满页面宽度**（贴页边距），不与正文列对齐 | AppBar 本来就该满宽；1180 下页头右缘 **1156** 与详情列右缘 **896** 有 **260px 分歧** | 真 top bar 落地时按 M3 定语（页头右侧是操作区，不跟随列宽） | //! | 2 | 空态标题 `HeadlineSmall 24` 比页标题 `TitleLarge 22` 大 | 12b §15.2 明确「空态是唯一允许 Headline 级的场景」，与 §16.4 的页标题档有 spec 张力 | 有意保留，不修 | -//! | 3 | 单列页（下载 / 日志）在 1180 下只用掉 **48%** 内容宽（435/1044） | 行宽上限的必然结果；空态居中不显空 | 版本浏览真正接数据后重新决议 `PaneKit`（现在写「一串线性进度项」是按单列定的） | +//! | 3 | 单列页（下载 / 日志）在 1180 下只用掉 **40.6%** 内容宽（424/1044） | 行宽上限的必然结果；空态居中不显空 | 版本浏览真正接数据后重新决议 `PaneKit`（现在写「一串线性进度项」是按单列定的） | //! | 4 | 空态图标字形 **40px**（12b 15.1 是 `[估]` 32~48） | 令牌 `IconSize` 只有 24 一档，`frame::glyph` 按尺寸重算 stroke | 组件库的 `EmptyState`（M77）落地时 | //! | 5 | 窄窗「Back to instances」没有前导箭头 | 占位文本按钮没有图标位 | 真 top bar / M78 的导航件落地时 | //! | 6 | 实例页「未选中详情」空态**没有出图** | 演示数据固定选中第 1 条；空态代码路径在（`detail_empty`） | D30 状态矩阵补齐时补一张，不必重跑全套 |