From 38b1e7a4ddfd42fb2df8ab3b8d358cc7f3e8a39d Mon Sep 17 00:00:00 2001 From: AskaEth Date: Mon, 2 Nov 2026 10:42:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(iced/feedback):=20=E5=81=8F=E7=A6=BB?= =?UTF-8?q?=E7=BC=96=E5=8F=B7=E3=80=81=E5=9B=BE=E6=B3=A8=20L3=E3=80=81[?= =?UTF-8?q?=E4=BC=B0]=20=E5=8F=A3=E5=BE=84=E4=B8=8E=E6=B7=B1=E8=89=B2=20sc?= =?UTF-8?q?rim=20=E8=A7=82=E5=AF=9F=E9=A1=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 复审 r1 的文档/证据订正（都是「图注与登记不一致」这类，但视觉 reviewer 正是照图注看图）： - gallery 图注「SurfaceContainerHigh + L3」→ 补「（本项目不画阴影，见 D-1）」； - `snackbar.rs` 的「登记为偏离 D-3」→ D-4（D-3 是进度条波浪降级，之前混号了）； - `mod.rs`「三条偏离」→ 四条，并把深色档 scrim 的观察项登记成 D-5； - `empty_state.rs` 开头「本文件数值全部是 [估]」→ 按表逐项区分 `[估]/[规格]/[源]`； - `action.rs` 模块文档补一句「禁用色的底必须是这两个动作件自己的容器角色」。 --- crates/app-iced/src/components/feedback/mod.rs | 4 +++- crates/app-iced/src/components/feedback/snackbar.rs | 3 ++- crates/app-iced/src/components/gallery/feedback.rs | 2 +- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/crates/app-iced/src/components/feedback/mod.rs b/crates/app-iced/src/components/feedback/mod.rs index 0089586..0edd03c 100644 --- a/crates/app-iced/src/components/feedback/mod.rs +++ b/crates/app-iced/src/components/feedback/mod.rs @@ -26,7 +26,8 @@ //! //! 本家族零模糊、零运行时半透明：进度条是实色、Dialog 的 scrim 是**预合成实色** //! （[`scrim`]），两个浮层都不画阴影（`ShadowSpec` 还是 M63 占位值 + D27 禁模糊）。 -//! 三条偏离逐条登记在报告里（D-1 无阴影 / D-2 scrim 预合成 / D-3 波浪未实现）。 +//! 四条偏离逐条登记在报告里（D-1 无阴影 / D-2 scrim 预合成 / D-3 波浪未实现 / D-4 Snackbar 无阴影）， +//! 另有一条**观察项** D-5（深色档 scrim 只压暗 4%，见 `dialog.rs` 的 scrim 一节）。 //! //! ## 逐项偏离登记（提交报告里同一份表） //! @@ -37,6 +38,7 @@ //! | D-3 | 线性波浪 3/40、环形 1.6/15 | 直线段 / 等弧长 | `12b §12.4` 明确允许，登记后用匀速替代 | 是 | //! | D-4 | Snackbar L3 阴影 | 无阴影 | 同 D-1 | 是 | //! | G17-d | Snackbar 最小宽 344 | 组件不强制（宿主保证） | iced `Length` 无 min-width（同按钮 G15） | 是（自定义 Widget） | +//! | D-5 | 深色档 scrim 压暗 32% | 保持 0.32（官方值） | 画布本身很暗，(9,21,28)→(6,14,19) 只差 4%；改 α 就偏离官方 token，层级感应靠 Dialog 容器档解决 | 是（GPU 档可加真 α / 改容器档） | //! //! ## 文件地图 //! diff --git a/crates/app-iced/src/components/feedback/snackbar.rs b/crates/app-iced/src/components/feedback/snackbar.rs index 489a3b5..713dd49 100644 --- a/crates/app-iced/src/components/feedback/snackbar.rs +++ b/crates/app-iced/src/components/feedback/snackbar.rs @@ -28,7 +28,8 @@ //! ## 不画阴影 //! //! 官方是 L3，但 D27（CPU 档禁模糊）与令牌层 `ShadowSpec` 仍是 M63 占位值这两条都指向 -//! 「先不画」——层级靠 `InverseSurface` 与页面的 scrim/留白表达。登记为偏离 D-3。 +//! 「先不画」——层级靠 `InverseSurface` 与页面的 scrim/留白表达。登记为偏离 **D-4** +//! （D-3 是进度条的波浪降级，别混号）。 use iced::widget::{container, row, text}; use iced::{Alignment, Background, Border, Element, Length, Padding}; diff --git a/crates/app-iced/src/components/gallery/feedback.rs b/crates/app-iced/src/components/gallery/feedback.rs index ec65680..2ce10fd 100644 --- a/crates/app-iced/src/components/gallery/feedback.rs +++ b/crates/app-iced/src/components/gallery/feedback.rs @@ -297,7 +297,7 @@ fn dialog_block<'a>(ui: &'a Ui, full: bool) -> Element<'a, DemoMessage> { let mut body = column![caption( ui, - "Dialog · R28 · SurfaceContainerHigh + L3 · pad 24（标题下 16 / 正文下 24）· 动作 Primary 间距 8", + "Dialog · R28 · SurfaceContainerHigh + L3（**本项目不画阴影，见 D-1**）· pad 24（标题下 16 / 正文下 24）· 动作 Primary 间距 8", )] .spacing(ui.space(Space::X2));