docs: define status bar semantic colors
This commit is contained in:
@@ -69,7 +69,7 @@
|
||||
|
||||
- `删除批次`(①)、`删除账号`(④)等不可逆动作:按钮文字和描边用 danger `#cf222e`,与普通灰按钮区分;保持原有启用/禁用和二次确认逻辑不变。二次确认弹窗仍是主防线,颜色只是二级提示。
|
||||
|
||||
### 7)状态栏全局提示色(建议,未落地)
|
||||
### 7)状态栏全局提示色(T-543 待落地)
|
||||
|
||||
左下角状态栏是低打扰反馈,不应做成醒目的大色块。建议只改变状态栏文字颜色,并在每次显示普通提示时重置样式,避免上一条红色/绿色残留到下一条普通消息。
|
||||
|
||||
@@ -84,13 +84,15 @@
|
||||
- 状态栏只做辅助反馈,不能替代弹窗、空状态、运行日志和按钮禁用等主反馈。
|
||||
- 高频进度信息用 info;不会继续执行、但用户可通过配置/选择修复的问题用 warning;已经失败或阻断当前动作的问题用 danger。
|
||||
- 不建议给所有状态栏消息都上强颜色;普通导航、就绪、筛选数量等信息保持 muted 或默认色,避免长期使用时视觉疲劳。
|
||||
- T-543 落地时统一使用 `MainWindow.show_status(message, level)`;新增状态栏提示必须显式传入 `level`,不长期依赖中文关键词猜测。
|
||||
- T-543 第一版覆盖主窗口和 ①②③④⑤ Tab 现有状态栏调用;状态栏只作为辅助反馈,不改变弹窗、空状态、运行日志、任务状态列或按钮禁用的主反馈职责。
|
||||
|
||||
## 实现映射(PySide6,落地时参考)
|
||||
|
||||
- **状态色**:在各 TableModel 的 `data()` 里响应 `Qt.ForegroundRole`(必要时 `Qt.BackgroundRole`)按内部 `stage/status` 返回 `QColor`;不要按中文显示文案硬匹配,不要在 QSS 里做,表格单元格上色走 model role 最稳。
|
||||
- **按钮/汇总数字**:用 `objectName` + 集中 QSS。建议把语义色板定义为 `app/gui.py` 顶部的一组常量(如 `COLOR_SUCCESS = "#1a7f37"`),QSS 与 `QColor` 都引用同一常量,杜绝散落硬编码。③ Tab 单独标识如需落地,用 `setTabIcon(2, ...)`,不要试图用 QSS nth 选择器。
|
||||
- **登录点**:文字前缀 `●` 用 `QColor`,或状态列走 ForegroundRole。
|
||||
- **状态栏**:建议在 `MainWindow` 增加统一入口(如 `show_status(message, level="info")`),内部映射 level 到色板并调用 `statusBar().showMessage(message)`;现有 `self.statusBar().showMessage(...)` 后续逐步替换为该入口。第一版如需兼容旧调用,可用轻量关键词兜底分类(失败/错误/异常/点数不足/未登录→danger,完成/成功/已保存/已回写→success,没有/请先/未配置→warning,正在/开始/进度/检测中→info),但新增代码应优先显式传 `level`,不要长期依赖中文字符串匹配。
|
||||
- **状态栏**:T-543 在 `MainWindow` 增加统一入口 `show_status(message, level="muted")`,内部映射 level 到色板、设置状态栏文字色并调用 `statusBar().showMessage(message)`;普通/就绪提示必须重置为 muted 或默认色,避免上一条 danger/success 残留。现有 `self.statusBar().showMessage(...)` 与传给 Tab 的 `status_callback` 需要替换为该入口或显式等级包装。第一版如需兼容旧调用,可用轻量关键词兜底分类(失败/错误/异常/点数不足/未登录→danger,完成/成功/已保存/已回写→success,没有/请先/未配置→warning,正在/开始/进度/检测中→info),但新增代码必须显式传 `level`,不要长期依赖中文字符串匹配。
|
||||
- **复用**:所有红/绿/蓝/琥珀只从色板常量取值,新增组件一律引用,不新造颜色。
|
||||
|
||||
## 非目标(明确不做)
|
||||
|
||||
Reference in New Issue
Block a user