AskaEth
7b80b0e314
pages::Model.forced 此前只到得了外壳 + 实例页（唯一消费者 pages/instances.rs:159）， 设置页「外观」区的滑块/文本框/裸 iced::button 全都不消费它 ⇒ M284 那四处状态层 （语言档 / 主题档 / 日志 action_button / 外观 choice）只有单测证据，做不出像素判据。 改动： - settings/mod.rs: resolve_state(forced, status) 与 forced_button(button, forced) 成为全仓唯一两个「forced 怎么解释」的点；view → form → section_columns 一路 新增 forced 形参（默认 None ⇒ 今天的行为逐字节不变）。 - Group.body（registry.rs）加第 4 个形参 Option<Interaction>，六组统一签名。 - 四类裸 iced::button 控件把 forced 递进样式闭包并经 resolve_state 落地： 语言档 chip（general/language.rs）、主题档 chip（general/theme.rs）、 日志 action_button（logs_row.rs）、外观 choice（appearance/section/mod.rs， 含 accent/window/bg_image/colour_source 共 10 处调用）。 - components::buttons::Button 的三组（update / ai / java）走 forced_button 的 .state()。 - harness: request.rs 解析 --force-state=rest|hover|pressed（未知值报错，词与产品 cli.rs 同一套），slug 加 -hover/-pressed；app.rs 把它写进 model.forced， 截图通道默认 Rest 的纪律保持（显式值优先）。 - pages/mod.rs: 唯一调用点把 model.forced 传给 settings::view（397 → 399 行）。 单测：resolve_state 的 Some 覆盖 / None 退回；forced_button 的 Some 钉态 / None 原样。
303 lines
13 KiB
Rust
303 lines
13 KiB
Rust
//! 外观分组第 ⓪ 段（视觉上排在最前）：**自定义强调色**（M250 ACCENTWIRE）。
|
||
//!
|
||
//! 为什么这一段值得单开：`appearance.accent_color` 从 M41 起就有键、有 presenter 往返、
|
||
//! 有 `ACCENT_PRESETS` 色板，却**没有任何 UI 写者**——造 tokens 的唯一入口恒走
|
||
//! `DesignTokens::brand(board)`，用户即使改了配置文件，界面也不会变。接线之后这一段就是那条
|
||
//! 链路的手动入口，也是**非法值唯一能被看见的地方**（错行紧贴输入框，不折叠、不写进日志了事）。
|
||
//!
|
||
//! ## 三件控件对应的键与消息
|
||
//!
|
||
//! | 控件 | 键 | 消息 |
|
||
//! |---|---|---|
|
||
//! | 强调色文本框（受控，输入即生效） | `appearance.accent_color` | [`Change::Accent`] |
|
||
//! | 「出厂」+ 8 个预设色块 | 同上（写入色板里的 hex） | [`Change::Accent`] |
|
||
//! | 非法值错行 | —（不进配置） | 无 |
|
||
//!
|
||
//! ## 色块为什么画成圆点而不是药丸
|
||
//!
|
||
//! 9 颗写着十六进制串的药丸会变成一排噪声，而且色相要靠读字获取——色板控件的可见内容**就是**
|
||
//! 颜色本身。所以色块 = `ShapeScale::Full` 的实心圆 + 描边；选中态加粗描边（不靠色相区分：
|
||
//! 色块底下垫的是它自己的颜色，色相对比不可靠）。
|
||
|
||
use iced::widget::tooltip::{self, Tooltip};
|
||
use iced::widget::{button, column, container, row, text, Space as Gap};
|
||
use iced::{Background, Border, Element, Length, Padding, Shadow, Theme as IcedTheme};
|
||
|
||
use unlucky_design::color::Role;
|
||
use unlucky_design::shape::ShapeScale;
|
||
use unlucky_design::spacing::Space;
|
||
use unlucky_i18n::catalog::Key;
|
||
use unlucky_i18n::Lang;
|
||
use unlucky_presenter::prefs::{AccentError, ACCENT_PRESETS};
|
||
|
||
use crate::app::components::inputs::{text_field, Field};
|
||
use crate::app::components::interaction::Interaction;
|
||
use crate::pages::Message;
|
||
use crate::theme::{to_iced, Ui, STROKE_PX};
|
||
|
||
use super::super::accent::Accent;
|
||
use super::super::state::State;
|
||
use super::super::Change;
|
||
use super::{choice, label, note_line, t, tr};
|
||
|
||
/// 把 ⓪ 段推进 `rows`。
|
||
pub(super) fn push<'a>(
|
||
ui: &'a Ui,
|
||
state: &'a State,
|
||
lang: Lang,
|
||
forced: Option<Interaction>,
|
||
rows: &mut Vec<Element<'a, Message>>,
|
||
) {
|
||
let accent = &state.accent;
|
||
|
||
// 受控输入框 + 失败态：`Field::error()` 让框本身变成错误色，错行再补「错在哪」。
|
||
let mut field = Field::new(accent.text())
|
||
.label(t(Key::SettingsAppearanceAccent, lang))
|
||
.placeholder("#RRGGBB")
|
||
// P18：回车 = 立即提交（把「打了一半就放着」的 `#12` 亮成红框 + 错行）。
|
||
// **不是**逐键报错：敲字那条路（`Change::Accent`）照旧只在「不可能再变合法」时才亮红。
|
||
.on_submit(accent_commit);
|
||
if accent.error().is_some() {
|
||
field = field.error();
|
||
}
|
||
let input: Element<'a, Message> = text_field(ui, field, |value| {
|
||
Message::Appearance(Change::Accent(value))
|
||
});
|
||
rows.push(
|
||
column![label(ui, t(Key::SettingsAppearanceAccent, lang)), input]
|
||
.spacing(ui.space(Space::X1))
|
||
.width(Length::Fill)
|
||
.into(),
|
||
);
|
||
|
||
rows.push(presets(ui, accent, lang, forced));
|
||
|
||
// 非法值：**结构化的原因**，不是「格式不对」这种没法行动的一句话。
|
||
if let Some(error) = accent.error() {
|
||
let text = reason(lang, error);
|
||
rows.push(note_line(ui, &text, ui.color(Role::Error)));
|
||
}
|
||
|
||
// 说明：空 = 出厂板；自定义色只换三族（中性表面与 error 保持基线是 design 既定语义）。
|
||
rows.push(note_line(
|
||
ui,
|
||
t(Key::SettingsAppearanceAccentHint, lang),
|
||
ui.color(Role::OnSurfaceVariant),
|
||
));
|
||
}
|
||
|
||
/// 回车那一下要发的那条消息——**唯一产地**（M252 / P18）。
|
||
///
|
||
/// 抽成函数是为了让「回车 = 提交」这件事在源码里只有一个写法：`section/accent.rs` 把它交给
|
||
/// `Field::on_submit`，测试按它钉住「回车走的是 `AccentCommit` 而不是又一条 `Accent(原文)`」
|
||
/// （后者是**逐键**路径，会把已经亮出来的错重新吞回去）。
|
||
fn accent_commit() -> Message {
|
||
Message::Appearance(Change::AccentCommit)
|
||
}
|
||
|
||
/// 「预设」两行：先「标签 + 出厂」，再一排 8 颗色块。
|
||
///
|
||
/// 为什么分两行：一行放 9 个控件在设置卡片的正文宽度里会被挤成「7 + 1」折行，最后一颗色块
|
||
/// 孤零零掉到下一行（出图实测）。分两行是**有意**的排版，不是被挤出来的。
|
||
fn presets<'a>(
|
||
ui: &'a Ui,
|
||
accent: &'a Accent,
|
||
lang: Lang,
|
||
forced: Option<Interaction>,
|
||
) -> Element<'a, Message> {
|
||
let current = accent.persist_value();
|
||
let head = row![
|
||
container(label(ui, t(Key::SettingsAppearanceAccentPresets, lang)))
|
||
.align_y(iced::Alignment::Center),
|
||
choice(
|
||
ui,
|
||
t(Key::SettingsAppearanceAccentFactory, lang),
|
||
current.is_empty(),
|
||
Change::Accent(String::new()),
|
||
forced,
|
||
),
|
||
]
|
||
.spacing(ui.space(Space::X2))
|
||
.align_y(iced::Alignment::Center);
|
||
|
||
let swatches: Vec<Element<'a, Message>> = ACCENT_PRESETS
|
||
.iter()
|
||
.map(|hex| swatch(ui, hex, current == *hex))
|
||
.collect();
|
||
|
||
column![
|
||
head,
|
||
row(swatches)
|
||
.spacing(ui.space(Space::X2))
|
||
.align_y(iced::Alignment::Center),
|
||
]
|
||
.spacing(ui.space(Space::X2))
|
||
.width(Length::Fill)
|
||
.padding(Padding::from([ui.space(Space::X2), 0.0]))
|
||
.into()
|
||
}
|
||
|
||
/// 一颗色块：实心圆 + 描边（选中态加粗）。点击写入该预设。
|
||
fn swatch<'a>(ui: &'a Ui, hex: &'static str, selected: bool) -> Element<'a, Message> {
|
||
let fill = unlucky_design::color::Color::from_hex(hex).map(to_iced);
|
||
// 直径取控件高度的六成（40 → 24dp）：与药丸按钮同一行时不抢节奏。
|
||
let diameter = ui.metrics().control_height * 0.6;
|
||
let ring = if selected {
|
||
ui.color(Role::OnSurface)
|
||
} else {
|
||
ui.color(Role::OutlineVariant)
|
||
};
|
||
let width = if selected { STROKE_PX * 2.0 } else { STROKE_PX };
|
||
let radius = ui.radius(ShapeScale::Full, diameter);
|
||
|
||
let dot: Element<'a, Message> = button(
|
||
Gap::new()
|
||
.width(Length::Fixed(diameter))
|
||
.height(Length::Fixed(diameter)),
|
||
)
|
||
.padding(Padding::from(0.0))
|
||
.style(move |_theme: &IcedTheme, status| button::Style {
|
||
background: fill.map(Background::Color),
|
||
text_color: ring,
|
||
border: Border {
|
||
color: match status {
|
||
button::Status::Hovered | button::Status::Pressed => ui.color(Role::OnSurface),
|
||
_ => ring,
|
||
},
|
||
width,
|
||
radius,
|
||
},
|
||
shadow: Shadow::default(),
|
||
snap: true,
|
||
})
|
||
.on_press(Message::Appearance(Change::Accent(hex.to_owned())))
|
||
.into();
|
||
|
||
// 色块本体只有颜色、没有字：补一条可读提示（hex），否则键盘与读屏用户只能靠位置辨色。
|
||
Tooltip::new(dot, hint(ui, hex), tooltip::Position::Top).into()
|
||
}
|
||
|
||
/// 色块的悬停提示：`Overlay` 底 + `BodySmall` 的 hex 原文（与 `pages/agent` 的 tooltip 同一手法）。
|
||
fn hint<'a>(ui: &'a Ui, hex: &'a str) -> iced::widget::Container<'a, Message> {
|
||
let style = ui.style(unlucky_design::typography::TypeRole::BodySmall);
|
||
container(
|
||
text(hex.to_owned())
|
||
.size(style.size_px)
|
||
.font(ui.font_of(style))
|
||
.color(ui.color(Role::OnSurface)),
|
||
)
|
||
.padding(Padding::from([ui.space(Space::X1), ui.space(Space::X2)]))
|
||
.style(move |_theme: &IcedTheme| container::Style {
|
||
background: Some(Background::Color(
|
||
ui.layer(unlucky_design::elevation::MaterialLayer::Overlay),
|
||
)),
|
||
border: Border {
|
||
radius: ui.radius_dp(ShapeScale::Small),
|
||
..Border::default()
|
||
},
|
||
..container::Style::default()
|
||
})
|
||
}
|
||
|
||
/// 结构化原因 → 一句话（参数由 Rust 侧格式化，词表只认 `{name}`）。
|
||
fn reason(lang: Lang, error: AccentError) -> String {
|
||
match error {
|
||
AccentError::Short { digits } => tr(
|
||
lang,
|
||
Key::SettingsAppearanceAccentShort,
|
||
&[("digits", &digits.to_string())],
|
||
),
|
||
AccentError::Long { digits } => tr(
|
||
lang,
|
||
Key::SettingsAppearanceAccentLong,
|
||
&[("digits", &digits.to_string())],
|
||
),
|
||
AccentError::Digit { ch } => tr(
|
||
lang,
|
||
Key::SettingsAppearanceAccentDigit,
|
||
&[("ch", &visible(ch))],
|
||
),
|
||
}
|
||
}
|
||
|
||
/// 把一个字符变成**看得见**的形态：控制字符 / 空白 / 零宽与双向控制符（`Cf`）一律写 `U+XXXX`。
|
||
///
|
||
/// 为什么不能直接 `ch.to_string()`：用户粘进来的可能是不换行空格、零宽空格或 RTL 覆盖符——
|
||
/// 那几个字符在句子里**看不见**，错行会变成「强调色里有非十六进制字符：」后面一片空白，
|
||
/// 用户根本不知道自己错在哪。
|
||
fn visible(ch: char) -> String {
|
||
if ch.is_alphanumeric() || ch.is_ascii_graphic() {
|
||
ch.to_string()
|
||
} else {
|
||
format!("U+{:04X}", u32::from(ch))
|
||
}
|
||
}
|
||
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use super::visible;
|
||
|
||
/// 本文件源码（源码结构断言用，与 `pages/layout/source.rs` 同一条纪律）。
|
||
const SOURCE: &str = include_str!("accent.rs");
|
||
|
||
/// **M252 / P18 回车接线的判据**：`push` 里有一**行代码**接了 `on_submit`，实参整取等于
|
||
/// `accent_commit`，且那个产地发的确实是 `AccentCommit`（提交）而不是 `Accent(原文)`（敲字）。
|
||
///
|
||
/// iced 的 `Element` 没有内省接口（见 `pages::layout::source` 的模块文档），所以「回车真的
|
||
/// 按下去」在这里量不到——能钉住的是**它接的是哪条消息**。
|
||
///
|
||
/// - 抓得住：`.on_submit(..)` 被删掉 **或注释掉**（`source::code_line` 先剥注释，判的是**代码行**）；
|
||
/// 实参被换成同前缀的别的产地（`accent_commit_none`——`call_arguments` 是**整取**，不是子串）；
|
||
/// 接成 `Change::Accent(原文)`（那是**逐键**路径，`retry(false)` 会把已经亮起来的错吞回去）。
|
||
/// - 抓不住：按键真的到达控件（iced 的 `Widget::update`）、以及红框/错行画没画（出图负责）。
|
||
#[test]
|
||
fn the_accent_field_wires_enter_to_commit() {
|
||
let body = crate::pages::layout::source::function_body(SOURCE, "fn push");
|
||
let line =
|
||
crate::pages::layout::source::code_line(body, ".on_submit(").unwrap_or_else(|| {
|
||
panic!("`push` 里没有一行**代码**接 `on_submit`（注释掉也算没有）：\n{body}")
|
||
});
|
||
|
||
// 实参**整取**（不是子串）：`accent_commit_none` 这种同前缀产地不许静默通过。
|
||
assert_eq!(
|
||
crate::pages::layout::source::call_arguments(&line, ".on_submit("),
|
||
vec!["accent_commit"],
|
||
"回车必须接 `accent_commit`（唯一产地），实际接线：{line}"
|
||
);
|
||
|
||
// 产地本身发什么：先看**代码行**（注释里的字不算），再跑一次拿 `Debug` 文本核形态
|
||
// （`Message` 没有 `PartialEq`）。
|
||
let factory = crate::pages::layout::source::function_body(SOURCE, "fn accent_commit");
|
||
assert!(
|
||
crate::pages::layout::source::code_lines(factory)
|
||
.iter()
|
||
.any(|line| line.contains("Change::AccentCommit")),
|
||
"产地必须发 `Change::AccentCommit`（提交），实际函数体：\n{factory}"
|
||
);
|
||
assert_eq!(
|
||
format!("{:?}", super::accent_commit()),
|
||
format!(
|
||
"{:?}",
|
||
crate::pages::Message::Appearance(super::Change::AccentCommit)
|
||
),
|
||
"回车那条消息必须是 `AccentCommit`（提交），不是 `Accent(原文)`（敲字）"
|
||
);
|
||
}
|
||
|
||
/// 错行里的字符必须**看得见**：不可见字符写成 `U+XXXX`，可见字符原样（r1 小事 2）。
|
||
///
|
||
/// 抓得住：把 `visible` 改回 `ch.to_string()`——`U+00A0` / `U+200B` 那两条立刻红（错行会变成
|
||
/// 「强调色里有非十六进制字符：」后面一片空白，用户不知道自己错在哪）。
|
||
/// 抓不住：句子本身（词表在 `unlucky-i18n`）。
|
||
#[test]
|
||
fn invisible_characters_are_shown_as_code_points() {
|
||
assert_eq!(visible('\u{a0}'), "U+00A0", "不换行空格看不见");
|
||
assert_eq!(visible('\u{200b}'), "U+200B", "零宽空格看不见");
|
||
assert_eq!(visible('\u{202e}'), "U+202E", "RTL 覆盖符看不见");
|
||
assert_eq!(visible(' '), "U+0020", "普通空格也看不见");
|
||
assert_eq!(visible('z'), "z", "可见字符原样");
|
||
assert_eq!(visible('#'), "#", "ASCII 标点原样");
|
||
assert_eq!(visible('中'), "中", "非 ASCII 可见字符原样");
|
||
}
|
||
}
|