首次提交,未改动文件
@@ -0,0 +1,67 @@
|
||||
# 📱 核心 UI 翻新与重构体系 (UITask 原型车间)
|
||||
|
||||
> **⚠️ 智能体请注意 (Agent Prompt & Protocol)**:
|
||||
> 如果您被唤醒并要求接手本目录的 UI 任务,**请不要一上来就盲目生成代码!**
|
||||
> 您必须充当“UI 架构师”的角色,严格按照以下的 **“一步一答 (Step-by-Step) 交互式协议”** 引导人类用户完成工作流。您的最终目标是集齐 7 件标准物料。
|
||||
|
||||
## 🔄 您的交互式工作流 (Step-by-Step Protocol)
|
||||
|
||||
当您(新手智能体)被人类协作者唤醒,并收到这张 README 时,请按顺序执行以下 6 个步骤。**每完成一步,必须停下来等待用户的回复,严禁抢跑**:
|
||||
|
||||
### 📁 Step 1: 确定界面归属与建仓 (防覆盖)
|
||||
- **您的动作**:询问用户:“请问本次重构属于哪个界面?是否是某个主界面下的子界面(例如:主界面/侧滑抽屉)?”
|
||||
- **执行**:根据用户的回答,自动在 `.agents/UITask/` 下为您创建对应的物理文件夹路径。
|
||||
- **⚠️ 强制规则**:为了防止覆盖过往版本,创建的文件夹必须带有当天的日期后缀(例如:`UITask/用户管理界面-20260816/`)。
|
||||
|
||||
> **🌟 AI 能力自检探针 (Capability Check)**
|
||||
> 在执行前,请 AI 评估自身当前具备哪些具体的 Tool/API 权限,并据此调整策略:
|
||||
> - **文件读写能力**:能否在后台静默创建文件/目录并打包ZIP?(有则静默创建,无则转为纯对话指导模式)
|
||||
> - **附件提取能力**:能否将人类发在聊天框里的**多媒体图片附件**直接转化为本地磁盘文件?(⚠️注意:绝大多数代码助手仅能读写文本,无法提取图片二进制流。**若无提取图片的 Tool,必须在涉及图片的步骤请求人类协助**)。
|
||||
> - **文件访问透明度**:人类能否直接在电脑上双击打开你写的文件?(如本地 IDE 插件可以;如果是云端沙盒,则需你在聊天框打印 HTML 代码供其复制)。
|
||||
|
||||
### 📷 Step 2 & 3: 获取视觉资产 (原图与效果图)
|
||||
- **您的动作 (基于能力)**:
|
||||
- **若有图片提取能力**:直接提取聊天框里的图片,静默保存为 `actual_ui.png` 和 `target_style.png`。
|
||||
- **若无图片提取能力 (最常见情况)**:向人类承认限制:“长官,由于我目前无法直接下载聊天附件,请您帮忙将原图存为 `actual_ui.png`,期望图存为 `target_style.png`,并放在我刚建好的目录中。存好后请通知我。”
|
||||
- **交互**:确认图片就位后,再进行下一步。
|
||||
|
||||
### 💻 Step 4: 编码 HTML 与循环调优 (防死锁)
|
||||
- **您的动作**:读取那两张图,开始编写 `baseline_ui.html`,完成后由您自动写入该目录中。
|
||||
- **交互**:告诉用户该 HTML 文件的本地绝对路径,让用户双击用浏览器打开。
|
||||
- **循环**:询问用户哪里有问题,反复修改 HTML 直到用户确认满意。
|
||||
- **⚠️ 防死锁警告**:HTML 原型的核心目的是敲定排版结构和颜色 Token。如果您在尝试还原复杂动画或生僻字体时遭遇挫折,请主动放弃像素级的死磕,向用户说明情况并以快速输出图纸为主,切勿陷入无限修改的死循环。
|
||||
|
||||
### 📸 Step 5: 获取最终定妆照 (final_effect.png)
|
||||
- **您的动作**:在用户确认 HTML 完美后,请用户在浏览器里截取最终效果图。
|
||||
- **动作 (基于能力)**:有图片提取能力则自动保存;无提取能力则指导人类手动保存为 `final_effect.png`。
|
||||
|
||||
### 📐 Step 6: 自动生成图纸与资产交付 (终局)
|
||||
- **您的动作**:提取 HTML 里的 CSS 逻辑,生成并保存以下 3 份标准文件:
|
||||
1. `DESIGN_SPEC.md` (视觉边界手册)
|
||||
2. `implementation_plan.md` (原生映射图纸)
|
||||
3. `CARD-YYYYMMDD-UITask-模块名.md` (最终的重构卡片模板)
|
||||
- **资产终局交付 (基于能力)**:
|
||||
- **若文件访问透明度高 (本地 IDE)**:输出完整的本地硬盘绝对路径,请用户验货。
|
||||
- **若在云端沙盒**:将 7 个文件打包为 ZIP,并提供下载链接/入口。
|
||||
- **若是纯聊天环境 (无文件写权限)**:将 3 份 Markdown 文档内容以代码块形式逐个在聊天框中输出,指导用户复制。
|
||||
|
||||
完成后,再次回到人机循环,等待用户的下一个新指令。
|
||||
|
||||
### 第一部分:视觉与 HTML 原型 (原型试错)
|
||||
1. 📷 **`actual_ui.png`**:真实环境中的旧版/老旧界面截图(用于保底,确保任何原有信息槽位绝不丢失)。
|
||||
2. 🖼️ **`target_style.png`**:期望的视觉风格参考图。
|
||||
3. 🖼️ **`final_effect.png`**:最终定稿的完美 UI 效果图。
|
||||
4. 🌐 **`baseline_ui.html`**:**[核心输出]** 您必须手写的 HTML/CSS 源代码。所有排版、颜色、状态机的讨论都在此 HTML 上进行,直到视觉达成完全一致。
|
||||
|
||||
### 第二部分:约束字典与落地图纸
|
||||
5. 📐 **`DESIGN_SPEC.md`**:纯视觉说明手册(涵盖透明度、边界条件、空白状态、截断规则等)。
|
||||
6. 🛠️ **`implementation_plan.md`**:原生 Android 施工图纸。必须包含严格的 **CSS-to-Android Token 映射字典**(绝对禁止 XML 硬编码颜色和尺寸)。
|
||||
|
||||
### 第三部分:执行契约
|
||||
7. 📋 **`CARD-YYYYMMDD-UITask-模块名.md`**:最终的重构任务卡片。里面只需简明扼要地标明改动文件,并声明严格遵守 `UI_DEV_GUIDE.md` 即可。
|
||||
|
||||
---
|
||||
|
||||
## 🛑 行动准则
|
||||
- **只做设计,不碰原生**:您的工作止步于产出这 7 份文件。Android 端的实际修改,由后续的 `@coder` 去根据您产出的这 7 份物料执行。
|
||||
- **Token 宪法**:在您编写 `implementation_plan.md` 时,时刻对照同级目录下的 `UI_DEV_GUIDE.md`,把您 HTML 里的 `#FFFFFF` 映射为 `?attr/colorSurface`,把 `12px` 映射为 `@dimen/corner_radius_md`。
|
||||
|
After Width: | Height: | Size: 473 KiB |
|
After Width: | Height: | Size: 459 KiB |
|
After Width: | Height: | Size: 464 KiB |
|
After Width: | Height: | Size: 101 KiB |
|
After Width: | Height: | Size: 171 KiB |
|
After Width: | Height: | Size: 174 KiB |
|
After Width: | Height: | Size: 204 KiB |
|
After Width: | Height: | Size: 272 KiB |
|
After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 626 KiB |
|
After Width: | Height: | Size: 310 KiB |
|
After Width: | Height: | Size: 346 KiB |
|
After Width: | Height: | Size: 316 KiB |
|
After Width: | Height: | Size: 336 KiB |
|
After Width: | Height: | Size: 283 KiB |
|
After Width: | Height: | Size: 79 KiB |
|
After Width: | Height: | Size: 123 KiB |
|
After Width: | Height: | Size: 196 KiB |
|
After Width: | Height: | Size: 191 KiB |
|
After Width: | Height: | Size: 141 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
After Width: | Height: | Size: 215 KiB |
|
After Width: | Height: | Size: 84 KiB |
|
After Width: | Height: | Size: 142 KiB |
|
After Width: | Height: | Size: 96 KiB |
|
After Width: | Height: | Size: 161 KiB |
|
After Width: | Height: | Size: 165 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 124 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
After Width: | Height: | Size: 73 KiB |
|
After Width: | Height: | Size: 135 KiB |
@@ -0,0 +1,81 @@
|
||||
---
|
||||
title: "APP界面优化 - 系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传)"
|
||||
status: "TODO"
|
||||
created: "2026-08-16"
|
||||
level: 1
|
||||
---
|
||||
|
||||
# 任务目标
|
||||
对系统设置类 5 张页面执行**纯美化**重构(不改信息架构、不改交互范式、不丢任何字段),
|
||||
核心解决平板宽屏下"内容顶左上角、右侧大片留白"的排版失衡问题,统一为 840dp 居中内容容器;
|
||||
同时修复数据上传页三个输入框的物理重叠错位、选择版型页选中态描边逻辑颠倒等具体 Bug。
|
||||
|
||||
## 开发依据(4 件套约束)
|
||||
> 🚨 **绝对约束**:请 `@coder` 在修改代码前,**必须必须必须**先阅读以下工作台目录的全部 3 份基准物料,
|
||||
> 并同步阅读全局公约 `../BEAUTIFY_BASELINE_20260816.md` 与 Token 宪法 `../UI_DEV_GUIDE.md`。严禁自行发挥 UI 排版!
|
||||
>
|
||||
> **工作台路径**:`.agents/UITask/系统设置界面-20260816/`
|
||||
> 1. `baseline_ui.html`:**[必读]** 终极 HTML 排版基准源代码,5 个 `<section>` 对应 5 屏,顶部 `:root` 为全量 Token 声明。
|
||||
> 2. `DESIGN_SPEC.md`:**[必读]** 视觉边界手册 —— 840dp 栅格规范、五屏逐项差异点、状态机、截断规则、最小点击区域、与公约的差异声明。
|
||||
> 3. `implementation_plan.md`:**[必读]** CSS→Android Token 映射字典 + 已实际检索确认的落地文件清单 + 风险/待确认项。
|
||||
>
|
||||
> **原始截图**(未复制,相对路径引用,`@coder` 核对信息槽位用):
|
||||
> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143341.png`(语言设置)
|
||||
> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143347.png`(选择版型)
|
||||
> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143456.png`(版本信息)
|
||||
> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143502.png`(Logo 授权管理)
|
||||
> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143450.png`(数据上传)
|
||||
|
||||
## 涉及文件(详细改动点见 `implementation_plan.md` §2,此处仅列清单)
|
||||
|
||||
**Layout**
|
||||
- `app/src/main/res/layout/activity_language_settings.xml`
|
||||
- `app/src/main/res/layout/activity_edition_selection.xml`
|
||||
- `app/src/main/res/layout/activity_version_info.xml`
|
||||
- `app/src/main/res/layout/activity_logo_management.xml`
|
||||
- `app/src/main/res/layout/activity_data_upload.xml`
|
||||
|
||||
**Java / Activity / ViewModel**
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.java`
|
||||
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/upload/DataUploadActivity.java`
|
||||
|
||||
**资源(新增 Token / 样式 / drawable)**
|
||||
- `app/src/main/res/values/dimens.xml`(新增 `content_max_width`、`settings_form_label_width`、`settings_row_height`)
|
||||
- `app/src/main/res/values/colors.xml`(核对 `color_secondary_container` 取值)
|
||||
- `app/src/main/res/values/themes.xml`(新增 `Widget.EAPManage.Button.Segmented`,补充 Toolbar `titleTextAppearance`)
|
||||
- 新增 `app/src/main/res/drawable/selector_language_row_bg.xml`
|
||||
- 新增 `app/src/main/res/drawable/shape_badge_error.xml`、`shape_badge_success.xml`
|
||||
|
||||
## 执行步骤清单
|
||||
1. **840dp 居中容器**:按 `DESIGN_SPEC.md` §1 落地统一栅格规范,5 屏全部收敛;语言设置页保持"外层通栏可点、内层视觉居中"的双层结构(`implementation_plan.md` §3.2)。
|
||||
2. **修复数据上传页三输入框重叠错位**:`ConstraintLayout` 改写为竖向 `LinearLayout` + 四行横向两列结构(`implementation_plan.md` §2.5),标签列固定 140dp。
|
||||
3. **修复选择版型页选中态描边颠倒**:两张卡的 `strokeColor`/`strokeWidth`/圆点 tint 随选中状态动态联动,不再与卡片身份绑死(`implementation_plan.md` §3.3)。
|
||||
4. **语言设置**:行高 56dp、选中态背景反馈、分割线缩进对齐。
|
||||
5. **版本信息**:三卡标签列统一 140dp 对齐成列;"Debug" 由纯红字降级为徽章;下载更新按钮改为独立动作行。
|
||||
6. **Logo 授权管理**:分段控件按公约 §5.6 收口;预览条底色改为 surface+描边;计数器归位到输入框正下方。
|
||||
7. **黑色胶囊开关替换**:数据上传页 `SwitchCompat` → `MaterialSwitch`。
|
||||
8. 全部页面 AppBar 标题字号/返回箭头间距按公约 §3 统一。
|
||||
9. 自查 `DESIGN_SPEC.md` §6 清单逐条过一遍再提交。
|
||||
|
||||
## 验收标准
|
||||
- [ ] 平板横屏下 5 屏内容均为 840dp 居中显示,无"顶左上角+右侧大片留白"现象。
|
||||
- [ ] 数据上传页三个输入框标签与框对齐、互不重叠压盖。
|
||||
- [ ] 选择版型页:选中卡 = primary 描边 + primary-container 底,未选中卡为中性描边,两卡逻辑一致(不再一蓝一绿颠倒)。
|
||||
- [ ] 语言设置页:行高 56dp,选中行有背景反馈,分割线不再通栏到边。
|
||||
- [ ] 版本信息页:三张卡标签值对齐成列,Debug 变为浅红底徽章而非纯红字,下载更新按钮有分割线锚定。
|
||||
- [ ] Logo 授权管理页:分段控件、预览条、计数器均按 `DESIGN_SPEC.md` §3.4 收口。
|
||||
- [ ] 未丢失 `actual_ui.png`(原始截图)中的任何一个信息字段或功能入口。
|
||||
- [ ] 无散落十六进制颜色/尺寸,全部引用 `@color/`、`@dimen/`、`?attr/` Token(对照 `UI_DEV_GUIDE.md` §5 清单自查)。
|
||||
|
||||
## 附:待 @coder 二次确认的风险项(详见 `implementation_plan.md` §4,此处摘要)
|
||||
1. 公约字号阶梯(15sp/13sp)与仓库现有 `dimens.xml`(14sp/11sp)不完全对齐,建议先与其他并行 UI 子任务对齐字号基准表。
|
||||
2. `radius_lg`(12dp)与 `corner_radius_lg`(20dp)命名相近但数值不同,落地时需明确版型卡用前者。
|
||||
3. `color_secondary_container` 实际取值是否已是浅绿,需核实。
|
||||
4. 项目中是否已有 `MaxWidthXxxLayout` 类自定义容器可复用(用于承载 840dp 居中逻辑)。
|
||||
5. `MaterialCardView.strokeColor` 是否支持 ColorStateList(取决于 Material Components 版本),若不支持则版型卡选中态必须走代码动态设置而非 XML selector。
|
||||
6. `values-w600dp/`、`layout-w600dp/` 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。
|
||||
@@ -0,0 +1,252 @@
|
||||
# 系统设置类页面(5 屏)— 视觉边界手册 DESIGN_SPEC
|
||||
|
||||
- **模块**:系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传)
|
||||
- **日期**:2026-08-16
|
||||
- **最高约束**:`../BEAUTIFY_BASELINE_20260816.md`(全局美化公约) + `../UI_DEV_GUIDE.md`(Token 宪法)
|
||||
- **视觉基准**:同目录 `baseline_ui.html`(单文件,双击可开)
|
||||
- **原始截图**(不复制文件,相对路径引用):
|
||||
| 屏 | 截图 |
|
||||
| --- | --- |
|
||||
| 语言设置 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143341.png` |
|
||||
| 选择版型 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143347.png` |
|
||||
| 版本信息 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143456.png` |
|
||||
| Logo 授权管理 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143502.png` |
|
||||
| 数据上传 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143450.png` |
|
||||
|
||||
> **铁律复述**:本次只做美化。五屏的信息字段、按钮文案、区块顺序、交互范式全部原样保留。
|
||||
> 下文所有条目都属于「间距 / 对齐 / 描边 / 颜色语义 / 响应式收敛」范畴,不含信息架构改动。
|
||||
|
||||
---
|
||||
|
||||
## 1. ★ 宽屏内容容器(本模块要沉淀给全 App 的通用栅格规范)
|
||||
|
||||
### 1.1 问题
|
||||
五张截图全部在平板横屏(2944×1840,约 1280dp 宽)下拍摄,**内容一律顶在左上角、右侧留出 40%~60% 空白**。
|
||||
数据上传页最严重:三个输入框从左标签一直横跨到屏幕最右侧,单行长度超过 1000dp,眼睛需要横扫整块屏幕才能读完一行,
|
||||
且长 URL 在超宽单行里既读不出结构也无法快速比对。这是全 App 平板体验「廉价感」的头号来源。
|
||||
|
||||
### 1.2 规范(**全 App 通用,不限本模块**)
|
||||
|
||||
| 项 | 值 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| 内容容器最大宽度 | **840px / 840dp** | `--content-max-width`。超过即左右自动留白 |
|
||||
| 水平对齐 | **居中**(`margin: 0 auto`) | 不是左对齐后加右 padding |
|
||||
| 左右安全边距 | **24px / 24dp**(`--content-gutter`) | 窗口宽度 < 容器最大宽度时生效 |
|
||||
| 窄屏断点 | **600dp** | < 600dp 时安全边距降为 16dp,表单标签列由「左列」改为「上置」 |
|
||||
| 垂直起始留白 | 24dp(页面根 padding-top) | 列表型页面例外,见 1.4 |
|
||||
| AppBar | **全宽通栏,不进容器** | 对齐 Android `MaterialToolbar` 的物理行为;仅其内部标题遵守 §2 的 inset |
|
||||
|
||||
### 1.3 为什么是 840
|
||||
- 840dp 是 Material 3 Window Size Class 中 **Expanded 的下界**,天然与「平板横屏」这一档对齐;
|
||||
- 单行正文 15sp 时,840dp 约 60~70 个西文字符 / 40 个汉字,落在最佳阅读行宽区间;
|
||||
- 与项目已有但仍为空的 `res/values-w600dp/`、`res/layout-w600dp/` 资源目录方向一致,可直接落资源限定符。
|
||||
|
||||
### 1.4 三种页面的容器落法
|
||||
|
||||
| 页型 | 屏 | 落法 |
|
||||
| --- | --- | --- |
|
||||
| **卡片/表单型** | 选择版型、版本信息、Logo 管理、数据上传 | 滚动容器内包一层 `maxWidth=840dp + layout_gravity=center_horizontal` 的内容 LinearLayout,左右 padding 24dp |
|
||||
| **通栏列表型** | 语言设置 | **列表本体保持 match_parent**(触摸高亮/涟漪必须通栏,否则宽屏下点击右半屏无反馈),但**每一行的内部内容再收进 840dp 居中盒**,分割线同宽。视觉是居中的,可点区域是通栏的 |
|
||||
| **AppBar** | 全部 5 屏 | 通栏,不收敛 |
|
||||
|
||||
### 1.5 红线
|
||||
- **禁止**用「左对齐 + 右侧硬塞 padding」冒充居中,窗口再变宽就又偏了。
|
||||
- **禁止**给 840 容器加背景色或描边把它做成一张「大卡片」——它是不可见的排版栅格,不是视觉元素。
|
||||
- 容器最大宽度必须走 `@dimen` Token(`content_max_width`),**禁止在 XML 里写死 840dp**。
|
||||
|
||||
---
|
||||
|
||||
## 2. AppBar 统一规范(5 屏共用,对齐公约 §3)
|
||||
|
||||
| 项 | 值 |
|
||||
| --- | --- |
|
||||
| 高度 | 56dp(`--appbar-height`) |
|
||||
| 背景 | `--color-surface`,底部 `1px --divider` |
|
||||
| 返回箭头 | 图标 24dp,触控槽 48dp,**图标视觉左边界落在距屏幕左 16dp** |
|
||||
| 箭头与标题间距 | **8dp**(标题文本起点固定在 72dp = 16 + 48 + 8) |
|
||||
| 标题 | **20sp / 600 / `--text-primary`**,单行,超长 `ellipsize=end` |
|
||||
| 副标题(若有) | 12sp / `--text-secondary` |
|
||||
|
||||
> 截图现状:五屏标题字号目测在 22~24sp 之间浮动,箭头到标题的间距各屏不一(语言设置约 48dp、Logo 管理约 44dp)。统一收口到上表。
|
||||
|
||||
---
|
||||
|
||||
## 3. 分屏视觉规范
|
||||
|
||||
### 3.1 语言设置(`Screenshot_20260812_143341.png`)
|
||||
|
||||
| 问题(现状) | 规范(目标) |
|
||||
| --- | --- |
|
||||
| 行高偏矮、上下气口不足 | **行高 56dp**(公约 §5.5 的 48dp 是下限,设置类整屏列表提到 56dp 更从容),整行可点,最小点击区 48dp |
|
||||
| 分割线通栏顶到屏幕最左最右 | 分割线**左端缩进到文字起点**(与 840 容器左边界同轴),右端同样留 24dp 安全边距;**最后一行下方不画线** |
|
||||
| 选中项只有一个蓝圆点,无背景反馈 | 选中行 `--color-primary-container` 整行底 + 文字 `--color-on-primary-container` + 字重 500;圆点 `--color-primary` |
|
||||
| 分割线颜色用了 `colorSurfaceVariant`(面色当线色,偏重偏灰) | 统一 `--divider`(12% 黑),1dp |
|
||||
| 无 hover / pressed 反馈 | hover:primary 4% 透明;pressed:primary 8% 透明(Android 用 `?attr/selectableItemBackground` 的涟漪即可) |
|
||||
|
||||
- 文字:语言名 15sp / 400 / `--text-primary`;不缩写、不截断(9 个语种名最长 `Ελληνικά` 也很短,宽屏下永不溢出)。
|
||||
- 单选圆点:未选中 2dp `--outline` 空心圈;选中 2dp `--color-primary` 圈 + 内实心点。
|
||||
|
||||
### 3.2 选择版型(`Screenshot_20260812_143347.png`)
|
||||
|
||||
**核心 Bug:两张卡的描边逻辑颠倒。** 现状是「专业版(未选中)=蓝框、自定义功能版(已选中)=绿框」,
|
||||
描边颜色被写死成卡片身份色,跟选中状态毫无关系,用户第一眼会把蓝框读成「已选中」。
|
||||
|
||||
| 状态 | 描边 | 底色 | 圆点 | 投影 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| **未选中** | `1dp --divider` | `--color-surface` | `--outline` 空心 | Level 1 |
|
||||
| **选中** | `2dp --color-primary` | `--color-primary-container` | `--color-primary` 实心 | Level 2 |
|
||||
| hover(未选中) | `1dp --outline` | 不变 | 不变 | Level 1 |
|
||||
|
||||
- 选中态描边从 1dp 变 2dp 时,**内边距同步 -1dp**(16 → 15dp),保证文字不发生 1px 位移抖动。
|
||||
- 圆点 tint **两张卡必须一致**,都用 `--color-primary`;现状自定义卡用了 `colorSecondary`(绿),必须去掉。
|
||||
- 卡片圆角 `--corner-md` 12dp;卡内 padding 16dp;卡间距 16dp。
|
||||
- 「确定」按钮:确认类 → `--color-secondary-container` 底 + `--color-secondary` 字(保留截图的浅绿视觉),
|
||||
高度 44dp,圆角 12dp,宽度 `match_parent`(保持截图的通栏形态),但**受 840 容器约束**,不再横跨全屏。
|
||||
- 顶部图标 72dp、标题 20sp/600、副标题 13sp/`--text-secondary`,整组居中。
|
||||
|
||||
### 3.3 版本信息(`Screenshot_20260812_143456.png`)
|
||||
|
||||
| 问题 | 规范 |
|
||||
| --- | --- |
|
||||
| 三张卡的标签/值没有对齐成列(「硬件 ID:」「设备型号:」「Android 版本:」宽度各不同,值参差) | **左标签列固定 140dp**(`--label-col-width`),值列 `weight=1`;跨卡片共用同一列宽,三张卡的值形成一条通列 |
|
||||
| 「Debug」红字直接砸在白底上,过于刺眼 | 降级为**徽章**:`--color-error-container` 底 + `--color-error` 字,12sp/600,高 22dp,圆角 `--corner-sm`。Release 走 `--color-secondary-container` + `--color-secondary` |
|
||||
| 「下载更新」按钮孤悬卡片右下角,与上方文字无任何关联 | 独立成**动作行**:上方加 `1dp --divider` 分割线,行内 `justify-content: flex-end`,与分割线间距 16dp。按钮仍在右侧(不搬家),但被分割线「锚」住,不再漂浮 |
|
||||
| 卡片同时有描边和阴影 | §4 红线:**只留投影 Level 1**,去掉描边 |
|
||||
| 卡片间距 / 卡片内边距不一 | 卡片内边距 16dp,卡片之间 16dp |
|
||||
|
||||
- 标签 13sp / `--text-secondary`;值 15sp / `--text-primary`。
|
||||
- 硬件 ID 用等宽字体(`monospace`),并 `word-break: break-all`,超长时**换行而不是截断**(ID 不能被 `…` 吃掉)。
|
||||
- 版本号:`版本号` 13sp `--text-secondary` + 数值 `--color-primary` 500 字重。
|
||||
- 「升级来源」是 layout 中真实存在的槽位(`tv_version_info_upgrade_source`),检查阶段显示、无更新时隐藏,**不要在重构时删掉**。
|
||||
- 底部版权 13sp / `--text-secondary` / 居中。
|
||||
|
||||
**系统更新卡状态机**
|
||||
|
||||
| 状态 | 表现 |
|
||||
| --- | --- |
|
||||
| 检查中 | 状态文案「正在检查更新…」,按钮文案「检查更新」+ `disabled`(opacity .38) |
|
||||
| 已是最新 | 状态文案「已是最新版本」,按钮「检查更新」可点 |
|
||||
| 有新版本 | 显示「有新版本可用:x.xx.xxxx」,按钮「下载更新」(confirm 绿) |
|
||||
| 下载中 | 显示 4dp 高进度条(`--color-primary` / 轨道 `--color-surface-variant`,圆角 999),按钮 disabled |
|
||||
| 失败 | 状态文案 `--color-error`,按钮恢复为「重试」 |
|
||||
|
||||
### 3.4 Logo 授权管理(`Screenshot_20260812_143502.png`)
|
||||
|
||||
| 问题 | 规范 |
|
||||
| --- | --- |
|
||||
| 分段控件是两个拼在一起的 Outlined 按钮,选中的一个是浅绿底绿字,未选中是白底 + 深描边 | **公约 §5.6**:外层胶囊(999dp)`--color-surface-variant` 底 + 2dp 内衬;选中段 `--color-primary-container` 底 + `--color-on-primary-container` 字 + 前置 ✓ + Level 1 投影;未选中段透明底 + `--text-secondary` 字。段高 36dp,段最小宽 132dp |
|
||||
| 预览条底色 `colorSurfaceVariant`(灰紫色块),与浅色页面割裂,像贴了一张异物 | 预览条改为 `--color-surface` 底 + `1dp --divider` 描边 + `--corner-md`,高度 56dp(= 真实 AppBar 高度)。**它是「顶部栏的样子」,就该长得像顶部栏,不该是一块深色底板** |
|
||||
| 计数器「10/15」孤零零悬在输入框右下方外侧,位置突兀 | 计数器归位到**输入框正下方 4dp 的 field-footer 行**内,右对齐,13sp / `--text-secondary`;左侧同一行留给错误提示文案。超限时计数器与提示同时变 `--color-error` |
|
||||
| 输入框描边偏重 | 默认 `1dp --divider`,聚焦 `2dp --color-primary`(同步 -1dp padding 防抖),圆角 `--corner-sm` |
|
||||
|
||||
- 预览条内:返回箭头 24dp `--text-primary`,与标题间距 8dp;标题 20sp/600,`maxLines=1` + `ellipsize=end`(超 15 字符本就被计数器拦住,截断只是兜底)。
|
||||
- 按钮:「保存文本配置」= confirm 绿(`--color-secondary-container` + `--color-secondary`);「恢复默认名称」= 次按钮(透明底 + `1dp --outline` + `--color-primary` 字)。两按钮固定宽 240dp、居中、纵向间距 16dp(保持截图的上下堆叠形态)。
|
||||
- **图片 Logo 模式**(截图未拍到,但 layout 中真实存在):预览区无图时走公约 §5.7 三段式空态 —— 56dp `--text-disabled` 图标 → 「暂无 Logo 图片」16sp/500 → 「点击『添加 Logo』上传,建议 PNG 透明底」13sp/`--text-secondary`;图标与主文案间距 16dp,主辅 8dp。加载中显示 `ProgressBar`(`pb_cl900_loading`)。
|
||||
|
||||
### 3.5 数据上传(`Screenshot_20260812_143450.png`)
|
||||
|
||||
**核心 Bug:三个输入框实际发生了重叠错位。**
|
||||
|
||||
- **现象**:「表单上传地址」框的下沿压住「原始数据上传地址」框的上沿;「原始数据上传地址」框整体向右偏移了约一个标签的宽度,
|
||||
左边界与另外两个框对不齐;三个标签与各自输入框在垂直方向也没对准(标签偏上/偏下不一)。
|
||||
- **根因**(已核对 `activity_data_upload.xml`):每个 `TextInputLayout` 同时把 `Top_toTopOf` 和 `Bottom_toBottomOf` 约束到了自己那个
|
||||
`wrap_content` 的标签 `TextView` 上。标签实际只有约 24dp 高,而 OutlinedBox 输入框有 56dp 高——ConstraintLayout 只好把 56dp 的框
|
||||
**以 24dp 的标签为中心上下各溢出 16dp**。溢出部分不计入下一个控件的排版基准(下一个标签是 `Top_toBottomOf` 上一个 TIL),
|
||||
于是相邻两组之间就出现了物理重叠。此外三个 TIL 都写了 `layout_weight="1"`,在 ConstraintLayout 里是无效属性,纯噪音。
|
||||
|
||||
**规范版式:左标签 + 右输入框 两列对齐**(保留截图原有的「标签在左」信息架构,用户肌肉记忆不变)
|
||||
|
||||
```
|
||||
├── 24dp ──┬──── 140dp 标签列 ────┬── 16dp ──┬───────── 输入框(占满剩余)─────────┬── 24dp ──┤
|
||||
自动上传数据 [ M3 Switch ]
|
||||
表单上传地址 [ 56dp 输入框 ]
|
||||
原始数据上传地址 [ 56dp 输入框 ]
|
||||
数据传输端口 [ 56dp 输入框 ]
|
||||
```
|
||||
|
||||
| 项 | 值 |
|
||||
| --- | --- |
|
||||
| 整块表单容器 | 840dp 居中(§1),左右安全边距 24dp |
|
||||
| 标签列宽 | **固定 140dp**(`--label-col-width`),四行共用,形成硬左对齐列 |
|
||||
| 标签 ↔ 输入框水平间距 | 16dp |
|
||||
| 每行垂直对齐 | `center_vertical` —— 标签在 56dp 输入框的**垂直正中**,不再是「顶对齐 + 溢出」 |
|
||||
| 行与行的垂直间距 | **16dp**(`--spacing-md` 级),由外层容器统一给,不再靠约束互推 |
|
||||
| 输入框高度 | 56dp,圆角 `--corner-sm`,描边 `1dp --divider`,左内边距 16dp |
|
||||
| 开关 | **M3 MaterialSwitch**(52×32dp,轨道 `--color-surface-variant` / 选中 `--color-primary`),替换截图中的黑色胶囊开关(公约 §5.5 明确点名的旧版残留) |
|
||||
| 三按钮 | 与表单之间加 `1dp --divider` 分割线 + 16dp 间距;按钮横向排列、gap 16dp、高 44dp。「保存」= confirm 绿;「重置」「测试数据上传」= 次按钮(透明底 + `1dp --outline` + primary 字)。**顺序与文案完全不变** |
|
||||
| 窄屏(< 600dp) | 标签自动上移到输入框正上方(`--label-col-width: 100%`),字号降到 13sp / `--text-secondary`,行内间距 4dp |
|
||||
|
||||
**Android 侧的修法(细节见 `implementation_plan.md`)**:
|
||||
把 `ConstraintLayout` 换成**竖向 `LinearLayout` + 每行一个横向 `LinearLayout(gravity=center_vertical)`**。
|
||||
四行同构,标签列宽由 `@dimen` 统一给。所有跨控件的顶/底互相约束全部删除——这类错位在约束式布局里极易复发,
|
||||
线性布局在这个「四行等宽两列表单」的场景下更稳,也更符合「不改结构、只修错位」的目标。
|
||||
|
||||
**状态机**
|
||||
|
||||
| 状态 | 表现 |
|
||||
| --- | --- |
|
||||
| 默认 | 空框 + `--text-hint` placeholder(`http://xxx.xxx.xxx.xxx:xxxx/upload/form` / `.../upload/json` / 端口示例) |
|
||||
| 聚焦 | `2dp --color-primary` 描边,去掉底色 |
|
||||
| 校验失败 | `--color-error` 描边 + 框下 13sp `--color-error` 行内提示(如「请填写完整的 http(s):// 地址」) |
|
||||
| 自动上传关闭 | 三个地址/端口输入框整体 `opacity 0.38` 且不可编辑;**开关本体保持 1.0 且必须可交互**(沿用 `用户管理界面/DESIGN_SPEC.md` 的既有红线,否则用户无法重新开启) |
|
||||
| 测试中 | 「测试数据上传」按钮 disabled + 文案保持不变,通过 Snackbar 反馈结果,不新增 UI 槽位 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 全模块通用状态与边界
|
||||
|
||||
### 4.1 状态机
|
||||
| 状态 | 通用表现 |
|
||||
| --- | --- |
|
||||
| 默认 | 见各屏规范 |
|
||||
| 按下 / hover | 列表行 primary 8% / 4% 透明;按钮 `filter: brightness(0.96 / 0.92)` |
|
||||
| 禁用 | **统一 `opacity: 0.38`**,禁止另造一套灰色值 |
|
||||
| 加载 | 4dp 高线性进度条(`--color-primary`),或 24dp 圆形 `ProgressBar` |
|
||||
| 空 | 公约 §5.7 三段式(仅 Logo 图片模式会遇到) |
|
||||
| 错误 | `--color-error` 描边 + 13sp 行内提示;不用 Toast 顶替行内提示 |
|
||||
|
||||
### 4.2 截断规则
|
||||
| 内容 | 规则 |
|
||||
| --- | --- |
|
||||
| AppBar 标题 | 单行 `ellipsize=end` |
|
||||
| 语言名 | 不截断(内容极短,宽屏下永不溢出) |
|
||||
| Logo 预览标题 | 单行 `ellipsize=end`(兜底;正常路径由 15 字符上限拦住) |
|
||||
| 硬件 ID / 版本号 | **换行不截断**(`break-all`),完整 ID 必须可读可复制 |
|
||||
| 上传地址 | 单行横向滚动(输入框原生行为),不换行 |
|
||||
| 版型卡描述 | 最多 2 行,超出 `ellipsize=end`;840 容器下现有文案 1 行即可容纳 |
|
||||
|
||||
### 4.3 最小点击区域
|
||||
- **全部可点元素 ≥ 48×48dp**。
|
||||
- 语言行:整行 56dp 高 × 通栏可点。
|
||||
- 单选圆点视觉 20dp,但外套 48dp 触控槽(`--touch-min`)。
|
||||
- AppBar 返回箭头:图标 24dp,触控槽 48dp。
|
||||
- 分段控件单段 36dp 高:**这是唯一低于 48dp 的例外**,M3 分段控件规范如此;靠段最小宽 132dp 保证横向易点。
|
||||
|
||||
### 4.4 数字排版
|
||||
所有版本号、端口、ID、计数器统一 `font-variant-numeric: tabular-nums`(Android 侧对应等宽数字字体或 monospace),
|
||||
避免刷新时数值宽度跳动。
|
||||
|
||||
---
|
||||
|
||||
## 5. 与全局公约的差异点声明(必读)
|
||||
|
||||
| # | 差异 | 公约原文 | 本模块取值 | 理由 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 1 | 列表行高 | §5.5「选项行整行可点,行高 48px」 | **56dp** | 语言设置是整屏只有一个列表的设置页,48dp 在 1840px 高的平板上过于局促。48dp 仍作为**最小点击区**下限被满足 |
|
||||
| 2 | 卡片描边 | §5.3「卡片 = surface 底 + corner-md + Level 1 投影」 | 版型卡在**选中态**额外加 `2dp --color-primary` 描边 | 单选卡必须有强选中信号;此时投影降为 Level 2 承担层级、描边承担状态,不构成 §4 红线所指的「深灰 1px 描边 + 重投影」双重包边 |
|
||||
| 3 | 新增 Token | 公约未定义 | 新增 `--content-max-width: 840px`、`--content-gutter: 24px`、`--label-col-width: 140px` | 本模块沉淀的通用栅格规范,建议回写进公约 §2 供其余 7 个模块共用 |
|
||||
| 4 | 页面根内边距 | §2「页面根内边距 24px」 | 语言设置页 **上下 0 / 左右由行内承担** | 通栏列表页若给根 padding,触摸涟漪会缩进一圈,宽屏下右半屏点不动。改为行内 padding + 通栏可点 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 自查清单(对照公约 §8)
|
||||
|
||||
- [x] 每个信息字段都还在(含 layout 中存在但截图未拍到的 `升级来源` / `下载进度条` / `图片 Logo 模式`)
|
||||
- [x] 页面结构与原截图一一对应,无区块搬家、无入口迁移
|
||||
- [x] `baseline_ui.html` 中无散落十六进制,全部走 `var(--*)`
|
||||
- [x] 圆角 / 间距全部引用 Token 变量
|
||||
- [x] 字号只用了公约 §3 的层级(20 / 16 / 15 / 13 / 12)
|
||||
- [x] 黑色胶囊开关(数据上传页)已替换为 M3 样式
|
||||
- [x] 描边与投影无双重包边(差异点 #2 已单独声明)
|
||||
- [x] 空态、禁用态、加载态、错误态均已定义
|
||||
- [x] Token 映射字典见 `implementation_plan.md`
|
||||
@@ -0,0 +1,986 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>EAPManageUI - 系统设置类页面 美化基线 (5 屏)</title>
|
||||
<style>
|
||||
/* =========================================================================
|
||||
:root —— 全量 Token 声明(严格对齐 BEAUTIFY_BASELINE_20260816.md §1 / §2)
|
||||
HTML 内禁止散落十六进制,一律 var(--*)
|
||||
========================================================================= */
|
||||
:root {
|
||||
/* ── 主题色 ── */
|
||||
--color-primary: #3949AB;
|
||||
--color-on-primary: #FFFFFF;
|
||||
--color-primary-container: #E8EAF6;
|
||||
--color-on-primary-container:#1A237E;
|
||||
|
||||
/* ── 辅助色(次级操作 / 确认类按钮) ── */
|
||||
--color-secondary: #00897B;
|
||||
--color-secondary-container: #E0F2F1;
|
||||
--color-on-secondary: #FFFFFF;
|
||||
|
||||
/* ── 表面 ── */
|
||||
--color-surface: #FFFBFE;
|
||||
--color-on-surface: #1C1B1F;
|
||||
--color-surface-variant: #E7E0EC;
|
||||
--color-on-surface-variant: #49454F;
|
||||
--color-background: #F1F1F1;
|
||||
|
||||
/* ── 错误 ── */
|
||||
--color-error: #B3261E;
|
||||
--color-error-container: #FCEDEA;
|
||||
|
||||
/* ── 文字语义 ── */
|
||||
--text-primary: #1C1B1F;
|
||||
--text-secondary: #49454F;
|
||||
--text-disabled: #9E9E9E;
|
||||
--text-hint: #BDBDBD;
|
||||
|
||||
/* ── 线 ── */
|
||||
--divider: rgba(0,0,0,0.12);
|
||||
--outline: rgba(0,0,0,0.24);
|
||||
|
||||
/* ── 圆角 ── */
|
||||
--corner-sm: 8px;
|
||||
--corner-md: 12px;
|
||||
--corner-lg: 20px;
|
||||
--corner-pill: 999px;
|
||||
|
||||
/* ── 间距 ── */
|
||||
--spacing-xs: 4px;
|
||||
--spacing-sm: 8px;
|
||||
--spacing-md: 16px;
|
||||
--spacing-lg: 24px;
|
||||
--spacing-xl: 32px;
|
||||
|
||||
/* ── 字号阶梯(§3) ── */
|
||||
--font-title: 20px; /* AppBar 页面标题 */
|
||||
--font-subtitle: 16px; /* 区块标题 / 卡片标题 */
|
||||
--font-body: 15px; /* 正文 / 列表主行 */
|
||||
--font-caption: 13px; /* 辅助说明 / 单位 / 计数器 */
|
||||
--font-unit: 12px;
|
||||
|
||||
/* ── Elevation(§4) ── */
|
||||
--elev-1: 0 1px 2px rgba(0,0,0,0.06), 0 1px 3px rgba(0,0,0,0.04);
|
||||
--elev-2: 0 2px 4px rgba(0,0,0,0.08), 0 4px 8px rgba(0,0,0,0.04);
|
||||
--elev-3: 0 4px 12px rgba(0,0,0,0.10), 0 8px 24px rgba(0,0,0,0.06);
|
||||
|
||||
/* ── ★ 本模块沉淀给全 App 的通用栅格 Token ── */
|
||||
--content-max-width: 840px; /* 宽屏内容容器最大宽度 */
|
||||
--content-gutter: 24px; /* 内容容器左右安全边距 */
|
||||
--appbar-height: 56px; /* AppBar 高度 */
|
||||
--appbar-nav-slot: 48px; /* 返回箭头触控区 */
|
||||
--appbar-title-inset: 72px; /* 标题起始位置 = 16 + 48 + 8 */
|
||||
--row-height: 56px; /* 单选/设置列表行高(§5.5 加高版) */
|
||||
--field-height: 56px; /* 输入框高度(含浮动标签) */
|
||||
--label-col-width: 140px; /* 表单左标签列宽 */
|
||||
--touch-min: 48px; /* 最小点击区域 */
|
||||
}
|
||||
|
||||
* { box-sizing: border-box; margin: 0; padding: 0; }
|
||||
|
||||
html { -webkit-font-smoothing: antialiased; }
|
||||
|
||||
body {
|
||||
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
|
||||
"Helvetica Neue", "PingFang SC", "Microsoft YaHei", Arial, sans-serif;
|
||||
font-size: var(--font-body);
|
||||
color: var(--text-primary);
|
||||
background: var(--color-background);
|
||||
padding: var(--spacing-lg);
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
原型脚手架(不属于 App 本体,仅为在浏览器里模拟平板窗口)
|
||||
========================================================================= */
|
||||
.shot-label {
|
||||
max-width: 1120px;
|
||||
margin: var(--spacing-xl) auto var(--spacing-sm);
|
||||
font-size: var(--font-caption);
|
||||
color: var(--text-disabled);
|
||||
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
|
||||
}
|
||||
.shot-label b { color: var(--text-secondary); font-weight: 600; }
|
||||
|
||||
.screen {
|
||||
width: 100%;
|
||||
max-width: 1120px; /* 模拟平板横屏可视宽度 */
|
||||
margin: 0 auto var(--spacing-xl);
|
||||
background: var(--color-surface);
|
||||
border-radius: var(--corner-md);
|
||||
border: 1px solid var(--divider);
|
||||
box-shadow: var(--elev-1);
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
§3 AppBar —— 五屏统一
|
||||
全宽通栏(对齐 Android MaterialToolbar 的物理行为),标题 20/600
|
||||
========================================================================= */
|
||||
.appbar {
|
||||
height: var(--appbar-height);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
padding-left: var(--spacing-md);
|
||||
padding-right: var(--spacing-md);
|
||||
background: var(--color-surface);
|
||||
border-bottom: 1px solid var(--divider);
|
||||
}
|
||||
.appbar-nav {
|
||||
width: var(--appbar-nav-slot);
|
||||
height: var(--appbar-nav-slot);
|
||||
margin-left: -12px; /* 光学对齐:图标视觉左边界落在 16px */
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
border-radius: var(--corner-pill);
|
||||
cursor: pointer;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
.appbar-nav:hover { background: var(--color-surface-variant); }
|
||||
.appbar-nav svg { width: 24px; height: 24px; fill: var(--text-primary); }
|
||||
.appbar-title {
|
||||
font-size: var(--font-title);
|
||||
font-weight: 600;
|
||||
color: var(--text-primary);
|
||||
margin-left: var(--spacing-sm); /* 箭头与标题固定 8px */
|
||||
line-height: 1.2;
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
★ 宽屏内容容器 —— 本模块最大美化收益点
|
||||
全部内容收敛到 840px 居中,左右 24px 安全边距
|
||||
========================================================================= */
|
||||
.page {
|
||||
background: var(--color-background);
|
||||
min-height: 560px;
|
||||
padding: var(--spacing-lg) var(--content-gutter);
|
||||
}
|
||||
.page--flush { /* 通栏列表页(语言设置):容器不加左右 padding,靠行内 padding */
|
||||
padding-left: 0;
|
||||
padding-right: 0;
|
||||
padding-top: 0;
|
||||
}
|
||||
.content {
|
||||
width: 100%;
|
||||
max-width: var(--content-max-width);
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
}
|
||||
/* 窄屏(手机 / 分屏)回落:容器铺满,安全边距降为 16px */
|
||||
@media (max-width: 600px) {
|
||||
:root { --content-gutter: 16px; --label-col-width: 100%; }
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
通用原子件
|
||||
========================================================================= */
|
||||
.card {
|
||||
background: var(--color-surface);
|
||||
border-radius: var(--corner-md);
|
||||
box-shadow: var(--elev-1); /* §4 红线:投影与描边二选一,卡片走投影 */
|
||||
padding: var(--spacing-md);
|
||||
}
|
||||
.card + .card { margin-top: var(--spacing-md); }
|
||||
.card-title {
|
||||
font-size: var(--font-subtitle);
|
||||
font-weight: 600;
|
||||
color: var(--text-primary);
|
||||
margin-bottom: var(--spacing-sm); /* 区块标题与内容 8px */
|
||||
}
|
||||
|
||||
.btn {
|
||||
height: 44px;
|
||||
padding: 0 var(--spacing-lg);
|
||||
border: none;
|
||||
border-radius: var(--corner-md);
|
||||
font-size: var(--font-body);
|
||||
font-weight: 500;
|
||||
font-family: inherit;
|
||||
cursor: pointer;
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
transition: filter .15s ease, background-color .15s ease;
|
||||
}
|
||||
.btn:hover { filter: brightness(0.96); }
|
||||
.btn:active { filter: brightness(0.92); }
|
||||
.btn--primary { background: var(--color-primary); color: var(--color-on-primary); }
|
||||
.btn--confirm { background: var(--color-secondary-container); color: var(--color-secondary); }
|
||||
.btn--secondary { background: transparent; color: var(--color-primary); border: 1px solid var(--outline); }
|
||||
.btn--text { background: transparent; color: var(--color-primary); padding: 0 var(--spacing-md); }
|
||||
.btn[disabled], .btn.is-disabled { opacity: .38; pointer-events: none; }
|
||||
|
||||
/* =========================================================================
|
||||
§1 屏 1:语言设置 —— 单选列表
|
||||
行高 56px;分割线左侧缩进对齐文字;选中态 primary-container 底
|
||||
========================================================================= */
|
||||
.lang-list { width: 100%; }
|
||||
.lang-row {
|
||||
position: relative;
|
||||
height: var(--row-height);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
cursor: pointer;
|
||||
background: transparent;
|
||||
transition: background-color .15s ease;
|
||||
}
|
||||
/* 行内左右内边距 = 容器安全边距,保证与 840 容器同轴 */
|
||||
.lang-row-inner {
|
||||
width: 100%;
|
||||
max-width: var(--content-max-width);
|
||||
margin: 0 auto;
|
||||
padding: 0 var(--content-gutter);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: var(--spacing-md);
|
||||
height: 100%;
|
||||
}
|
||||
.lang-row:hover { background: rgba(57,73,171,0.04); }
|
||||
.lang-row.is-selected { background: var(--color-primary-container); }
|
||||
.lang-name {
|
||||
flex: 1;
|
||||
font-size: var(--font-body);
|
||||
color: var(--text-primary);
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
.lang-row.is-selected .lang-name { color: var(--color-on-primary-container); font-weight: 500; }
|
||||
|
||||
/* M3 单选圆点 */
|
||||
.radio {
|
||||
width: 20px; height: 20px; border-radius: 50%;
|
||||
border: 2px solid var(--outline);
|
||||
flex-shrink: 0; position: relative;
|
||||
}
|
||||
.radio.is-on { border-color: var(--color-primary); }
|
||||
.radio.is-on::after {
|
||||
content: ""; position: absolute; inset: 3px;
|
||||
border-radius: 50%; background: var(--color-primary);
|
||||
}
|
||||
/* 保证 20px 圆点仍有 48px 触控区 */
|
||||
.radio-slot {
|
||||
width: var(--touch-min); height: var(--touch-min);
|
||||
display: flex; align-items: center; justify-content: center;
|
||||
margin-right: -12px; flex-shrink: 0;
|
||||
}
|
||||
|
||||
/* 分割线:左侧缩进到文字起点,右侧留安全边距(不再通栏到边) */
|
||||
.lang-divider {
|
||||
width: 100%;
|
||||
max-width: var(--content-max-width);
|
||||
margin: 0 auto;
|
||||
padding: 0 var(--content-gutter);
|
||||
}
|
||||
.lang-divider i { display: block; height: 1px; background: var(--divider); }
|
||||
|
||||
/* =========================================================================
|
||||
§2 屏 2:选择版型 —— 单选卡
|
||||
========================================================================= */
|
||||
.hero { text-align: center; padding: var(--spacing-xl) 0 var(--spacing-lg); }
|
||||
.hero-icon {
|
||||
width: 72px; height: 72px; margin: 0 auto var(--spacing-md);
|
||||
border-radius: var(--corner-md);
|
||||
background: var(--color-surface);
|
||||
box-shadow: var(--elev-1);
|
||||
display: flex; align-items: center; justify-content: center;
|
||||
}
|
||||
.hero-icon svg { width: 40px; height: 40px; fill: var(--color-primary); }
|
||||
.hero-title { font-size: var(--font-title); font-weight: 600; color: var(--text-primary); }
|
||||
.hero-sub {
|
||||
font-size: var(--font-caption); color: var(--text-secondary);
|
||||
margin-top: var(--spacing-sm);
|
||||
}
|
||||
|
||||
/* 单选卡:选中 = primary 描边 + primary-container 底;未选中 = divider 细描边 + surface 底 */
|
||||
.choice {
|
||||
display: flex; align-items: flex-start; gap: var(--spacing-md);
|
||||
padding: var(--spacing-md);
|
||||
border-radius: var(--corner-md);
|
||||
background: var(--color-surface);
|
||||
border: 1px solid var(--divider);
|
||||
cursor: pointer;
|
||||
transition: border-color .15s ease, background-color .15s ease, box-shadow .15s ease;
|
||||
}
|
||||
.choice + .choice { margin-top: var(--spacing-md); }
|
||||
.choice:hover { border-color: var(--outline); }
|
||||
.choice.is-selected {
|
||||
border: 2px solid var(--color-primary);
|
||||
background: var(--color-primary-container);
|
||||
box-shadow: var(--elev-2);
|
||||
padding: calc(var(--spacing-md) - 1px); /* 补偿 2px 描边,避免选中时内容位移 */
|
||||
}
|
||||
.choice-radio { padding-top: 2px; }
|
||||
.choice-name { font-size: var(--font-subtitle); font-weight: 600; color: var(--text-primary); }
|
||||
.choice.is-selected .choice-name { color: var(--color-on-primary-container); }
|
||||
.choice-desc {
|
||||
font-size: var(--font-caption); color: var(--text-secondary);
|
||||
margin-top: var(--spacing-xs); line-height: 1.6;
|
||||
}
|
||||
.edition-actions { margin-top: var(--spacing-lg); }
|
||||
.edition-actions .btn { width: 100%; }
|
||||
|
||||
/* =========================================================================
|
||||
§3 屏 3:版本信息
|
||||
========================================================================= */
|
||||
.about-head { text-align: center; padding: var(--spacing-lg) 0 var(--spacing-lg); }
|
||||
.about-icon {
|
||||
width: 96px; height: 96px; margin: 0 auto var(--spacing-md);
|
||||
border-radius: var(--corner-lg);
|
||||
background: var(--color-surface);
|
||||
box-shadow: var(--elev-1);
|
||||
display: flex; align-items: center; justify-content: center;
|
||||
}
|
||||
.about-icon svg { width: 52px; height: 52px; fill: var(--color-primary); }
|
||||
.about-name { font-size: var(--font-title); font-weight: 600; color: var(--text-primary); }
|
||||
.about-version {
|
||||
font-size: var(--font-caption); color: var(--text-secondary);
|
||||
margin-top: var(--spacing-xs);
|
||||
}
|
||||
.about-version b { color: var(--color-primary); font-weight: 500; }
|
||||
.about-sep { height: 1px; background: var(--divider); margin: var(--spacing-lg) 0; }
|
||||
|
||||
/* 信息卡的标签/值对齐成列 */
|
||||
.kv-row {
|
||||
display: flex; align-items: baseline;
|
||||
min-height: 28px;
|
||||
}
|
||||
.kv-row + .kv-row { margin-top: var(--spacing-sm); }
|
||||
.kv-key {
|
||||
width: var(--label-col-width);
|
||||
flex-shrink: 0;
|
||||
font-size: var(--font-caption);
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
.kv-val {
|
||||
flex: 1;
|
||||
font-size: var(--font-body);
|
||||
color: var(--text-primary);
|
||||
word-break: break-all;
|
||||
}
|
||||
.kv-val--mono { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
|
||||
|
||||
/* Debug 徽章:从刺眼红字降级为 error-container 底 + error 字 */
|
||||
.badge {
|
||||
display: inline-flex; align-items: center;
|
||||
height: 22px; padding: 0 var(--spacing-sm);
|
||||
border-radius: var(--corner-sm);
|
||||
font-size: var(--font-unit); font-weight: 600;
|
||||
letter-spacing: .02em;
|
||||
}
|
||||
.badge--debug { background: var(--color-error-container); color: var(--color-error); }
|
||||
.badge--release { background: var(--color-secondary-container); color: var(--color-secondary); }
|
||||
|
||||
/* 更新卡的动作行:加顶分割线,按钮不再孤悬右下 */
|
||||
.card-actions {
|
||||
display: flex; align-items: center; justify-content: flex-end;
|
||||
gap: var(--spacing-sm);
|
||||
margin-top: var(--spacing-md);
|
||||
padding-top: var(--spacing-md);
|
||||
border-top: 1px solid var(--divider);
|
||||
}
|
||||
.progress {
|
||||
height: 4px; border-radius: var(--corner-pill);
|
||||
background: var(--color-surface-variant);
|
||||
overflow: hidden; margin-top: var(--spacing-sm);
|
||||
}
|
||||
.progress i { display: block; height: 100%; background: var(--color-primary); }
|
||||
.about-copyright {
|
||||
text-align: center; font-size: var(--font-caption);
|
||||
color: var(--text-secondary);
|
||||
margin-top: var(--spacing-xl); padding-bottom: var(--spacing-lg);
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
§4 屏 4:Logo 授权管理
|
||||
========================================================================= */
|
||||
/* §5.6 分段控件:胶囊 999px,高 36px */
|
||||
.segmented {
|
||||
display: inline-flex;
|
||||
padding: 2px;
|
||||
border-radius: var(--corner-pill);
|
||||
background: var(--color-surface-variant);
|
||||
margin: 0 auto var(--spacing-lg);
|
||||
}
|
||||
.seg-wrap { display: flex; justify-content: center; }
|
||||
.seg {
|
||||
height: 36px; min-width: 132px; padding: 0 var(--spacing-md);
|
||||
border: none; background: transparent;
|
||||
border-radius: var(--corner-pill);
|
||||
font-size: var(--font-body); font-family: inherit;
|
||||
color: var(--text-secondary);
|
||||
display: inline-flex; align-items: center; justify-content: center; gap: 6px;
|
||||
cursor: pointer;
|
||||
transition: background-color .15s ease, color .15s ease;
|
||||
}
|
||||
.seg:hover { color: var(--text-primary); }
|
||||
.seg.is-on {
|
||||
background: var(--color-primary-container);
|
||||
color: var(--color-on-primary-container);
|
||||
font-weight: 500;
|
||||
box-shadow: var(--elev-1);
|
||||
}
|
||||
.seg svg { width: 16px; height: 16px; fill: currentColor; }
|
||||
|
||||
.field-label {
|
||||
font-size: var(--font-caption);
|
||||
color: var(--text-secondary);
|
||||
margin-bottom: var(--spacing-sm);
|
||||
}
|
||||
/* 预览条:改为 surface 底 + 1px divider 描边,与页面同族不再割裂 */
|
||||
.preview-bar {
|
||||
height: var(--appbar-height);
|
||||
display: flex; align-items: center;
|
||||
padding: 0 var(--spacing-md);
|
||||
gap: var(--spacing-sm);
|
||||
background: var(--color-surface);
|
||||
border: 1px solid var(--divider);
|
||||
border-radius: var(--corner-md);
|
||||
}
|
||||
.preview-bar svg { width: 24px; height: 24px; fill: var(--text-primary); flex-shrink: 0; }
|
||||
.preview-title {
|
||||
font-size: var(--font-title); font-weight: 600; color: var(--text-primary);
|
||||
white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
|
||||
}
|
||||
|
||||
/* §5.2 输入框 */
|
||||
.textfield {
|
||||
position: relative;
|
||||
height: var(--field-height);
|
||||
border: 1px solid var(--divider);
|
||||
border-radius: var(--corner-sm);
|
||||
background: var(--color-surface);
|
||||
display: flex; align-items: flex-end;
|
||||
padding: 0 var(--spacing-md) 8px;
|
||||
transition: border-color .15s ease, border-width .15s ease;
|
||||
}
|
||||
.textfield-float {
|
||||
position: absolute; top: 8px; left: var(--spacing-md);
|
||||
font-size: var(--font-unit); color: var(--text-secondary);
|
||||
}
|
||||
.textfield input {
|
||||
width: 100%; border: none; outline: none; background: transparent;
|
||||
font-size: var(--font-body); font-family: inherit; color: var(--text-primary);
|
||||
padding: 0;
|
||||
}
|
||||
.textfield input::placeholder { color: var(--text-hint); }
|
||||
.textfield:focus-within {
|
||||
border: 2px solid var(--color-primary);
|
||||
padding: 0 calc(var(--spacing-md) - 1px) 7px;
|
||||
}
|
||||
.textfield:focus-within .textfield-float { color: var(--color-primary); }
|
||||
.textfield.is-error { border-color: var(--color-error); }
|
||||
|
||||
/* 计数器:右对齐挂在输入框正下方,caption 级,不再突兀 */
|
||||
.field-footer {
|
||||
display: flex; justify-content: space-between; align-items: center;
|
||||
margin-top: var(--spacing-xs);
|
||||
min-height: 18px;
|
||||
font-size: var(--font-caption);
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
.field-error { color: var(--color-error); }
|
||||
.counter { margin-left: auto; }
|
||||
|
||||
.logo-actions {
|
||||
display: flex; flex-direction: column; align-items: center;
|
||||
gap: var(--spacing-md);
|
||||
margin-top: var(--spacing-lg);
|
||||
}
|
||||
.logo-actions .btn { width: 240px; }
|
||||
|
||||
/* =========================================================================
|
||||
§5 屏 5:数据上传 —— 标签-输入框两列对齐版式(修复重叠错位)
|
||||
========================================================================= */
|
||||
.form-row {
|
||||
display: flex;
|
||||
align-items: center; /* 标签与 56px 输入框垂直居中 */
|
||||
gap: var(--spacing-md);
|
||||
min-height: var(--field-height);
|
||||
}
|
||||
.form-row + .form-row { margin-top: var(--spacing-md); } /* 表单控件行距 16px */
|
||||
.form-label {
|
||||
width: var(--label-col-width);
|
||||
flex-shrink: 0;
|
||||
font-size: var(--font-body);
|
||||
color: var(--text-primary);
|
||||
line-height: 1.4;
|
||||
}
|
||||
.form-control { flex: 1; min-width: 0; }
|
||||
/* 窄屏回落:标签上移到输入框上方,避免标签列挤压输入框 */
|
||||
@media (max-width: 600px) {
|
||||
.form-row { flex-direction: column; align-items: stretch; gap: var(--spacing-xs); }
|
||||
.form-label { width: 100%; font-size: var(--font-caption); color: var(--text-secondary); }
|
||||
}
|
||||
|
||||
/* §5.5 M3 开关(替换截图中的黑色胶囊开关) */
|
||||
.switch {
|
||||
width: 52px; height: 32px; flex-shrink: 0;
|
||||
border-radius: var(--corner-pill);
|
||||
background: var(--color-surface-variant);
|
||||
border: 2px solid var(--outline);
|
||||
position: relative; cursor: pointer;
|
||||
transition: background-color .18s ease, border-color .18s ease;
|
||||
}
|
||||
.switch::after {
|
||||
content: ""; position: absolute; top: 50%; left: 6px;
|
||||
width: 16px; height: 16px; border-radius: 50%;
|
||||
background: var(--color-on-surface-variant);
|
||||
transform: translateY(-50%);
|
||||
transition: left .18s ease, width .18s ease, height .18s ease, background-color .18s ease;
|
||||
}
|
||||
.switch.is-on { background: var(--color-primary); border-color: var(--color-primary); }
|
||||
.switch.is-on::after {
|
||||
left: 26px; width: 22px; height: 22px;
|
||||
background: var(--color-on-primary);
|
||||
box-shadow: var(--elev-1);
|
||||
}
|
||||
.switch-slot { display: flex; align-items: center; min-height: var(--touch-min); }
|
||||
|
||||
.form-actions {
|
||||
display: flex; gap: var(--spacing-md); flex-wrap: wrap;
|
||||
margin-top: var(--spacing-lg);
|
||||
padding-top: var(--spacing-md);
|
||||
border-top: 1px solid var(--divider);
|
||||
}
|
||||
|
||||
/* =========================================================================
|
||||
§6 状态演示条(原型辅助,说明状态机;非 App 内元素)
|
||||
========================================================================= */
|
||||
.states {
|
||||
max-width: 1120px; margin: 0 auto var(--spacing-xl);
|
||||
padding: var(--spacing-md) var(--spacing-lg);
|
||||
background: var(--color-surface);
|
||||
border: 1px dashed var(--outline);
|
||||
border-radius: var(--corner-md);
|
||||
}
|
||||
.states h4 {
|
||||
font-size: var(--font-caption); font-weight: 600;
|
||||
color: var(--text-secondary); margin-bottom: var(--spacing-sm);
|
||||
text-transform: uppercase; letter-spacing: .06em;
|
||||
}
|
||||
.states-row { display: flex; flex-wrap: wrap; gap: var(--spacing-md); align-items: center; }
|
||||
.state-chip {
|
||||
font-size: var(--font-caption); color: var(--text-secondary);
|
||||
display: flex; align-items: center; gap: var(--spacing-sm);
|
||||
}
|
||||
/* 空态(§5.7) */
|
||||
.empty {
|
||||
display: flex; flex-direction: column; align-items: center; justify-content: center;
|
||||
padding: var(--spacing-lg);
|
||||
}
|
||||
.empty svg { width: 56px; height: 56px; fill: var(--text-disabled); }
|
||||
.empty-title {
|
||||
font-size: var(--font-subtitle); font-weight: 500; color: var(--text-primary);
|
||||
margin-top: var(--spacing-md);
|
||||
}
|
||||
.empty-sub { font-size: var(--font-caption); color: var(--text-secondary); margin-top: var(--spacing-sm); }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<!-- =====================================================================
|
||||
屏 1 / 5 —— 语言设置
|
||||
===================================================================== -->
|
||||
<div class="shot-label">屏 1 / 5 · <b>Screenshot_20260812_143341.png</b> · 语言设置(9 种语言单选列表)</div>
|
||||
<div class="screen">
|
||||
<div class="appbar">
|
||||
<div class="appbar-nav"><svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg></div>
|
||||
<div class="appbar-title">语言设置</div>
|
||||
</div>
|
||||
|
||||
<div class="page page--flush">
|
||||
<div class="lang-list">
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">English</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">Français</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<!-- 当前选中项:primary-container 底 + primary 圆点 -->
|
||||
<div class="lang-row is-selected">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">中文</span>
|
||||
<span class="radio-slot"><span class="radio is-on"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">日本語</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">한국어</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">Español</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">Italiano</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">Ελληνικά</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="lang-divider"><i></i></div>
|
||||
|
||||
<!-- 末行不画分割线 -->
|
||||
<div class="lang-row">
|
||||
<div class="lang-row-inner">
|
||||
<span class="lang-name">Português</span>
|
||||
<span class="radio-slot"><span class="radio"></span></span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- =====================================================================
|
||||
屏 2 / 5 —— 选择版型
|
||||
===================================================================== -->
|
||||
<div class="shot-label">屏 2 / 5 · <b>Screenshot_20260812_143347.png</b> · 选择版型(两张单选卡 + 确定)</div>
|
||||
<div class="screen">
|
||||
<div class="appbar">
|
||||
<div class="appbar-nav"><svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg></div>
|
||||
<div class="appbar-title">选择版型</div>
|
||||
</div>
|
||||
|
||||
<div class="page">
|
||||
<div class="content">
|
||||
|
||||
<div class="hero">
|
||||
<div class="hero-icon">
|
||||
<svg viewBox="0 0 24 24"><path d="M5 9.2h3V19H5V9.2zM10.6 5h2.8v14h-2.8V5zm5.6 8H19v6h-2.8v-6z"/></svg>
|
||||
</div>
|
||||
<div class="hero-title">选择版型</div>
|
||||
<div class="hero-sub">请选择适合您使用场景的版型,后续可在设置中更改</div>
|
||||
</div>
|
||||
|
||||
<!-- 未选中:divider 细描边 + surface 底 -->
|
||||
<div class="choice">
|
||||
<span class="choice-radio"><span class="radio"></span></span>
|
||||
<div>
|
||||
<div class="choice-name">专业版</div>
|
||||
<div class="choice-desc">为专业场馆管理员设计,布局固定专业化,核心数据字段默认全开,开箱即用</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 选中:primary 2px 描边 + primary-container 底 -->
|
||||
<div class="choice is-selected">
|
||||
<span class="choice-radio"><span class="radio is-on"></span></span>
|
||||
<div>
|
||||
<div class="choice-name">自定义功能版</div>
|
||||
<div class="choice-desc">高度可配置,所有高级功能开放,适合研究员和高级用户</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="edition-actions">
|
||||
<button class="btn btn--confirm">确定</button>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- =====================================================================
|
||||
屏 3 / 5 —— 版本信息
|
||||
===================================================================== -->
|
||||
<div class="shot-label">屏 3 / 5 · <b>Screenshot_20260812_143456.png</b> · 版本信息(图标+版本号 + 设备/构建/系统更新 三卡)</div>
|
||||
<div class="screen">
|
||||
<div class="appbar">
|
||||
<div class="appbar-nav"><svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg></div>
|
||||
<div class="appbar-title">版本信息</div>
|
||||
</div>
|
||||
|
||||
<div class="page">
|
||||
<div class="content">
|
||||
|
||||
<div class="about-head">
|
||||
<div class="about-icon">
|
||||
<svg viewBox="0 0 24 24"><path d="M5 9.2h3V19H5V9.2zM10.6 5h2.8v14h-2.8V5zm5.6 8H19v6h-2.8v-6z"/></svg>
|
||||
</div>
|
||||
<div class="about-name">EAP Manage Team</div>
|
||||
<div class="about-version">版本号 <b>1.00.0000</b></div>
|
||||
</div>
|
||||
|
||||
<div class="about-sep"></div>
|
||||
|
||||
<!-- 卡 1:设备信息 -->
|
||||
<div class="card">
|
||||
<div class="card-title">设备信息</div>
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">硬件 ID:</div>
|
||||
<div class="kv-val kv-val--mono">15EA5B1C22D14D97</div>
|
||||
</div>
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">设备型号:</div>
|
||||
<div class="kv-val">TB375FC</div>
|
||||
</div>
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">Android 版本:</div>
|
||||
<div class="kv-val">16 (API 36)</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 卡 2:构建信息 -->
|
||||
<div class="card">
|
||||
<div class="card-title">构建信息</div>
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">构建类型:</div>
|
||||
<div class="kv-val"><span class="badge badge--debug">Debug</span></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 卡 3:系统更新 -->
|
||||
<div class="card">
|
||||
<div class="card-title">系统更新</div>
|
||||
<!-- 升级来源槽位(layout 中真实存在 tv_version_info_upgrade_source,按状态显隐) -->
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">升级来源:</div>
|
||||
<div class="kv-val" style="color:var(--color-primary)">内置升级包</div>
|
||||
</div>
|
||||
<div class="kv-row">
|
||||
<div class="kv-key">有新版本可用:</div>
|
||||
<div class="kv-val">1.00.0001</div>
|
||||
</div>
|
||||
<div class="card-actions">
|
||||
<button class="btn btn--confirm">下载更新</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="about-copyright">© 2026 UmiLab. All rights reserved.</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 版本信息 —— 系统更新卡的其余状态(原型说明用) -->
|
||||
<div class="states">
|
||||
<h4>版本信息 · 系统更新卡状态机</h4>
|
||||
<div class="states-row">
|
||||
<div class="state-chip">检查中:<span class="badge" style="background:var(--color-surface-variant);color:var(--text-secondary)">正在检查更新…</span></div>
|
||||
<div class="state-chip">已是最新:<button class="btn btn--secondary is-disabled" style="height:36px">检查更新</button></div>
|
||||
<div class="state-chip">下载中:
|
||||
<span style="width:160px;display:inline-block">
|
||||
<span class="progress"><i style="width:62%"></i></span>
|
||||
</span>
|
||||
<span>62%</span>
|
||||
</div>
|
||||
<div class="state-chip">构建类型 Release:<span class="badge badge--release">Release</span></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- =====================================================================
|
||||
屏 4 / 5 —— Logo 授权管理
|
||||
===================================================================== -->
|
||||
<div class="shot-label">屏 4 / 5 · <b>Screenshot_20260812_143502.png</b> · Logo 授权管理(分段控件 + 实时预览 + 输入框 + 两按钮)</div>
|
||||
<div class="screen">
|
||||
<div class="appbar">
|
||||
<div class="appbar-nav"><svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg></div>
|
||||
<div class="appbar-title">Logo 授权管理</div>
|
||||
</div>
|
||||
|
||||
<div class="page">
|
||||
<div class="content">
|
||||
|
||||
<!-- §5.6 分段控件 -->
|
||||
<div class="seg-wrap">
|
||||
<div class="segmented">
|
||||
<button class="seg is-on">
|
||||
<svg viewBox="0 0 24 24"><path d="M9 16.2 4.8 12l-1.4 1.4L9 19 21 7l-1.4-1.4L9 16.2z"/></svg>
|
||||
文本 Logo
|
||||
</button>
|
||||
<button class="seg">图片 Logo</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 顶部栏实时效果预览 -->
|
||||
<div class="field-label">顶部栏实时效果预览</div>
|
||||
<div class="preview-bar">
|
||||
<svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg>
|
||||
<span class="preview-title">EAP Manage</span>
|
||||
</div>
|
||||
|
||||
<div style="height:var(--spacing-lg)"></div>
|
||||
|
||||
<!-- 输入框 + 计数器 -->
|
||||
<div class="textfield">
|
||||
<span class="textfield-float">输入自定义团队名称</span>
|
||||
<input type="text" value="EAP Manage" placeholder="请输入团队名称">
|
||||
</div>
|
||||
<div class="field-footer">
|
||||
<span></span>
|
||||
<span class="counter">10/15</span>
|
||||
</div>
|
||||
|
||||
<div class="logo-actions">
|
||||
<button class="btn btn--confirm">保存文本配置</button>
|
||||
<button class="btn btn--secondary">恢复默认名称</button>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Logo 管理 —— 图片模式与错误态(原型说明用) -->
|
||||
<div class="states">
|
||||
<h4>Logo 授权管理 · 图片模式 / 边界态</h4>
|
||||
<div class="states-row" style="align-items:stretch">
|
||||
<div style="flex:1;min-width:280px">
|
||||
<div class="field-label">图片 Logo 未上传(§5.7 空态)</div>
|
||||
<div class="preview-bar" style="height:auto;padding:var(--spacing-md)">
|
||||
<div class="empty" style="width:100%;padding:var(--spacing-sm)">
|
||||
<svg viewBox="0 0 24 24"><path d="M21 19V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2zM8.5 13.5l2.5 3 3.5-4.5 4.5 6H5l3.5-4.5z"/></svg>
|
||||
<div class="empty-title">暂无 Logo 图片</div>
|
||||
<div class="empty-sub">点击「添加 Logo」上传,建议 PNG 透明底</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div style="flex:1;min-width:280px">
|
||||
<div class="field-label">超长输入(错误态 + 计数器变红)</div>
|
||||
<div class="textfield is-error">
|
||||
<span class="textfield-float" style="color:var(--color-error)">输入自定义团队名称</span>
|
||||
<input type="text" value="超长团队名称超长团队名称超长团队名称">
|
||||
</div>
|
||||
<div class="field-footer">
|
||||
<span class="field-error">名称最多 15 个字符</span>
|
||||
<span class="counter field-error">18/15</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- =====================================================================
|
||||
屏 5 / 5 —— 数据上传
|
||||
===================================================================== -->
|
||||
<div class="shot-label">屏 5 / 5 · <b>Screenshot_20260812_143450.png</b> · 数据上传(自动上传开关 + 三输入框 + 保存/重置/测试)</div>
|
||||
<div class="screen">
|
||||
<div class="appbar">
|
||||
<div class="appbar-nav"><svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg></div>
|
||||
<div class="appbar-title">数据上传</div>
|
||||
</div>
|
||||
|
||||
<div class="page">
|
||||
<div class="content">
|
||||
|
||||
<div class="card">
|
||||
|
||||
<!-- 开关行:与下方表单同用 140px 标签列,左边界对齐 -->
|
||||
<div class="form-row">
|
||||
<div class="form-label">自动上传数据</div>
|
||||
<div class="form-control switch-slot">
|
||||
<div class="switch"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ★ 三个输入框:标签列固定 140px + 输入框独占右列,行距 16px,杜绝重叠 -->
|
||||
<div class="form-row">
|
||||
<label class="form-label" for="f-form">表单上传地址</label>
|
||||
<div class="form-control">
|
||||
<div class="textfield" style="align-items:center;padding:0 var(--spacing-md)">
|
||||
<input id="f-form" type="text" placeholder="http://xxx.xxx.xxx.xxx:xxxx/upload/form">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label class="form-label" for="f-json">原始数据上传地址</label>
|
||||
<div class="form-control">
|
||||
<div class="textfield" style="align-items:center;padding:0 var(--spacing-md)">
|
||||
<input id="f-json" type="text" placeholder="http://xxx.xxx.xxx.xxx:xxxx/upload/json">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label class="form-label" for="f-port">数据传输端口</label>
|
||||
<div class="form-control">
|
||||
<div class="textfield" style="align-items:center;padding:0 var(--spacing-md)">
|
||||
<input id="f-port" type="text" inputmode="numeric" placeholder="8080">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="form-actions">
|
||||
<button class="btn btn--confirm">保存</button>
|
||||
<button class="btn btn--secondary">重置</button>
|
||||
<button class="btn btn--secondary">测试数据上传</button>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 数据上传 —— 状态机(原型说明用) -->
|
||||
<div class="states">
|
||||
<h4>数据上传 · 状态机</h4>
|
||||
<div class="states-row" style="align-items:stretch">
|
||||
<div style="flex:1;min-width:300px">
|
||||
<div class="field-label">聚焦态(2px primary 描边)</div>
|
||||
<div class="textfield" style="align-items:center;padding:0 calc(var(--spacing-md) - 1px);border:2px solid var(--color-primary)">
|
||||
<input type="text" value="http://192.168.1.20:8080/upload/form">
|
||||
</div>
|
||||
</div>
|
||||
<div style="flex:1;min-width:300px">
|
||||
<div class="field-label">校验失败(error 描边 + 行内提示)</div>
|
||||
<div class="textfield is-error" style="align-items:center;padding:0 var(--spacing-md)">
|
||||
<input type="text" value="192.168.1.20">
|
||||
</div>
|
||||
<div class="field-footer"><span class="field-error">请填写完整的 http(s):// 地址</span></div>
|
||||
</div>
|
||||
<div style="flex:1;min-width:300px">
|
||||
<div class="field-label">自动上传关闭 → 三输入框禁用(opacity .38)</div>
|
||||
<div class="switch-slot"><div class="switch"></div></div>
|
||||
<div class="textfield is-disabled" style="align-items:center;padding:0 var(--spacing-md);opacity:.38">
|
||||
<input type="text" placeholder="http://xxx.xxx.xxx.xxx:xxxx/upload/form" disabled>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,173 @@
|
||||
# 系统设置类页面(5 屏)— 原生落地图纸 implementation_plan
|
||||
|
||||
- **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md`,严格对齐 `../UI_DEV_GUIDE.md`(Token 宪法)与 `../BEAUTIFY_BASELINE_20260816.md`(全局公约)。
|
||||
- **性质**:本文件只做「原生落地图纸」,不改任何源码。所有路径均已在仓库 `E:\Bitbucket\EAPManageTeam\app\src\main\` 下实际检索确认(Glob + Read),无编造路径。
|
||||
- **执行方**:`@coder`。
|
||||
|
||||
---
|
||||
|
||||
## 1. CSS → Android Token 映射字典
|
||||
|
||||
### 1.1 颜色(`baseline_ui.html :root` → `res/values/colors.xml` 语义别名)
|
||||
|
||||
| HTML CSS 变量 | 取值 | Android 语义 Token | 现状 |
|
||||
| --- | --- | --- | --- |
|
||||
| `--color-primary` | #3949AB | `?attr/colorPrimary`(= `@color/color_primary` = `@color/md_theme_primary`) | ✅ 已存在,直接复用 |
|
||||
| `--color-on-primary` | #FFFFFF | `?attr/colorOnPrimary` | ✅ 已存在 |
|
||||
| `--color-primary-container` | #E8EAF6 | `?attr/colorPrimaryContainer`(= `@color/color_primary_container`) | ✅ 已存在 |
|
||||
| `--color-on-primary-container` | #1A237E | `?attr/colorOnPrimaryContainer` | ✅ 已存在 |
|
||||
| `--color-secondary` | #00897B | `?attr/colorSecondary`(= `@color/color_secondary`) | ✅ 已存在 |
|
||||
| `--color-secondary-container` | #E0F2F1 | `?attr/colorSecondaryContainer` | ⚠️ 需核对 `colors.xml` 中该 container 值是否为浅绿;若当前指向 M3 默认紫调,需在 `values/colors.xml` 补充/校正为浅绿,**不要新建平行 Token** |
|
||||
| `--color-on-secondary` | #FFFFFF | `?attr/colorOnSecondary` | ✅ 已存在 |
|
||||
| `--color-surface` | #FFFBFE | `?attr/colorSurface`(= `@color/color_surface`) | ✅ 已存在 |
|
||||
| `--color-on-surface` | #1C1B1F | `?attr/colorOnSurface` | ✅ 已存在 |
|
||||
| `--color-surface-variant` | #E7E0EC | `?attr/colorSurfaceVariant`(= `@color/color_surface_variant`) | ✅ 已存在 |
|
||||
| `--color-on-surface-variant` | #49454F | `?attr/colorOnSurfaceVariant` | ✅ 已存在 |
|
||||
| `--color-background` | #F1F1F1 | `?attr/colorBackground` / `@color/color_background` | ✅ 已存在 |
|
||||
| `--color-error` | #B3261E | `?attr/colorError`(= `@color/color_error`) | ✅ 已存在 |
|
||||
| `--color-error-container` | #FCEDEA | `?attr/colorErrorContainer` | ✅ 已存在(`Widget.App.Button.Danger` 已在用) |
|
||||
| `--text-primary` | = on-surface | `@color/text_primary` | ✅ 已存在 |
|
||||
| `--text-secondary` | = on-surface-variant | `@color/text_secondary` | ✅ 已存在 |
|
||||
| `--text-disabled` | #9E9E9E | `@color/text_disabled` | ✅ 已存在 |
|
||||
| `--text-hint` | #BDBDBD | `@color/text_hint` | ✅ 已存在 |
|
||||
| `--divider` | rgba(0,0,0,.12) | `@color/divider`(#1F000000) | ✅ 已存在 |
|
||||
| `--outline` | rgba(0,0,0,.24) | `@color/outline`(#99000000,公约标注"原 0.6 过重",本模块沿用公约值,不额外新增) | ✅ 已存在,语义值需与公约 §1 描述一致核对 |
|
||||
|
||||
### 1.2 尺寸 / 圆角(新增 Token,需在 `res/values/dimens.xml` 补充)
|
||||
|
||||
| HTML CSS 变量 | 取值 | 建议新增 Android Token | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `--content-max-width` | 840px | **新增** `@dimen/content_max_width` = 840dp | ★ 本模块核心新增 Token,建议同步提给其余 7 个并行模块复用 |
|
||||
| `--content-gutter` | 24px | 复用现有 `@dimen/spacing_lg`(16dp)**不匹配**,需**新增** `@dimen/content_gutter` = 24dp | 24dp 与 spacing_lg(16dp)/spacing_xl(24dp) 撞值;直接复用 `@dimen/spacing_xl` 即可,无需新增,见下方"精简建议" |
|
||||
| `--label-col-width` | 140px | **新增** `@dimen/settings_form_label_width` = 140dp | 数据上传页 / 版本信息页共用 |
|
||||
| `--row-height` | 56px | 复用现有 `@dimen/toolbar_height`(56dp)或**新增** `@dimen/settings_row_height` = 56dp 语义更清晰 | 建议新增语义 Token,避免和 AppBar 高度混用同一个 dimen 名 |
|
||||
| `--field-height` | 56px | Material TextInputLayout OutlinedBox 默认即约 56dp,无需新增 | `Widget.EAPManage.TextInputLayout` 已定义圆角,高度走组件默认值 |
|
||||
| `--corner-sm` | 8px | `@dimen/corner_radius_sm`(8dp) | ✅ 已存在 |
|
||||
| `--corner-md` | 12px | `@dimen/corner_radius_md`(12dp)或已用的 `@dimen/radius_lg`(12dp,命名歧义,见 §4 风险) | ⚠️ 见下方风险项 |
|
||||
| `--corner-lg` | 20px | `@dimen/corner_radius_lg`(20dp) | ✅ 已存在 |
|
||||
| `--spacing-xs/sm/md/lg/xl` | 4/8/16/24/32 | `@dimen/spacing_xs/sm/md/lg/xl` | ✅ 已存在,直接复用 |
|
||||
| `--touch-min` | 48px | `@dimen/touch_target_min`(48dp) | ✅ 已存在 |
|
||||
|
||||
**精简建议**:`--content-gutter` 直接映射到已有的 `@dimen/spacing_xl`(24dp),**不新增**同值 Token,避免 dimens.xml 进一步膨胀。
|
||||
|
||||
### 1.3 字号(`res/values/dimens.xml` 已有字号阶梯,按公约 §3 对齐)
|
||||
|
||||
| HTML CSS 变量 | 取值 | Android Token | 现状 |
|
||||
| --- | --- | --- | --- |
|
||||
| `--font-title`(AppBar 标题) | 20px | `@dimen/text_size_headline`(20sp) | ✅ 已存在,但 `activity_*.xml` 里 Toolbar 标题目前吃 `?attr/textAppearance` 默认值,**未显式引用**,需在 `Widget.EAPManage.Toolbar` 样式中显式指定 titleTextAppearance |
|
||||
| `--font-subtitle`(区块标题/卡片标题) | 16px | `@dimen/text_size_title`(16sp) | ✅ 已存在 |
|
||||
| `--font-body`(正文) | 15px | ⚠️ `dimens.xml` 现有阶梯是 14/16/18(`text_size_body=14sp`),**没有 15sp** | 需新增 `@dimen/text_size_body_15` = 15sp,或将本模块正文对齐到就近的 `text_size_body`(14sp)。**建议**:为保持与公约 §3 表格严格一致,新增 15sp Token,命名 `text_size_body`(与现有 14sp 的 `text_size_body` 冲突,需要 @coder 与全局 UI 组核实 14 vs 15 何者为准,本任务不擅自改现有 Token 语义) |
|
||||
| `--font-caption`(辅助说明) | 13px | ⚠️ 现有 `text_size_caption` = 11sp,不等于 13sp | 同上,建议新增或核实,@coder 落地前需与其他并行模块对齐,避免各模块各定义一套 13sp/11sp |
|
||||
| `--font-unit` | 12px | `@dimen/text_size_sm`(12sp) | ✅ 已存在 |
|
||||
|
||||
> **⚠️ 风险提示(写入 §4)**:公约 §3 定义的字号阶梯(20/16/15/13)与仓库现有 `dimens.xml` 字号阶梯(20 headline / 16 title / 14 body / 11 caption)**不完全对齐**(15 vs 14,13 vs 11)。这是**跨模块共性问题**,不是本模块独有,建议 @coder 在实施前先与其他并行 UI 子任务对齐一次"字号 Token 最终基准表",避免 8 个模块分别新增 8 套相近字号。本模块 `implementation_plan` 暂按"复用最接近的现有 Token"处理,**不新增字号 Token**,待全局基准表拍板后再统一改。
|
||||
|
||||
### 1.4 Elevation
|
||||
|
||||
| HTML CSS 变量 | Android 落地 |
|
||||
| --- | --- |
|
||||
| `--elev-1` | `app:cardElevation="@dimen/dimen_2dp"`(现有 `activity_version_info.xml` 已用 2dp,视觉上接近 Level 1,**沿用现状不改**) |
|
||||
| `--elev-2` | `app:cardElevation="@dimen/elevation_card"` 或新增 `card_elevation_selected` = 4dp(仅版型选中卡使用) |
|
||||
| `--elev-3` | 本模块无弹窗/BottomSheet,不涉及 |
|
||||
|
||||
### 1.5 组件样式复用
|
||||
|
||||
| HTML class | Android 复用样式 |
|
||||
| --- | --- |
|
||||
| `.btn--confirm`(浅绿确认按钮) | `Widget.EAPManage.Button.Tonal`(已在 5 个 layout 中普遍使用,**保持不变**,但需核对其 `backgroundTint`/`textColor` 是否真的落在 `colorSecondaryContainer`/`colorSecondary`,若当前 Tonal 样式走的是默认 M3 紫色系,需按 DESIGN_SPEC §3 补充 tint 覆盖) |
|
||||
| `.btn--secondary`(次按钮) | `Widget.EAPManage.Button.Outlined` |
|
||||
| `.switch`(M3 开关) | `com.google.android.material.materialswitch.MaterialSwitch`(**需替换** `activity_data_upload.xml` 中的 `androidx.appcompat.widget.SwitchCompat`,SwitchCompat 在部分主题下会渲染成黑色胶囊,正是公约 §5.5 点名的"旧版残留") |
|
||||
| `.card`(信息卡) | `com.google.android.material.card.MaterialCardView`,去描边只留 `cardElevation` |
|
||||
| `.textfield`(输入框) | `Widget.EAPManage.TextInputLayout`(已存在,8dp 圆角),聚焦态由 M3 组件默认处理,无需自定义 |
|
||||
| `.badge`(Debug/Release 徽章) | 新增极小号 `TextView` + `res/drawable/shape_badge_error.xml` / `shape_badge_success.xml`(背景色引用 `?attr/colorErrorContainer` / `?attr/colorSecondaryContainer`,圆角引用 `@dimen/corner_radius_sm`) |
|
||||
| `.segmented`(Logo 分段控件) | `MaterialButtonToggleGroup`(`activity_logo_management.xml` 已在用,仅需补充 `app:cornerRadius` 走 999dp 胶囊 + 选中态样式覆盖为 `colorPrimaryContainer`,当前是 `?attr/materialButtonOutlinedStyle`,选中态默认落 `colorSecondary` 系,需要单独定义 `Widget.EAPManage.Button.Segmented` 覆盖选中态 tint) |
|
||||
|
||||
---
|
||||
|
||||
## 2. 落地文件清单(已实际检索确认路径)
|
||||
|
||||
### 2.1 屏 1 — 语言设置
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| Layout | `app/src/main/res/layout/activity_language_settings.xml` | 9 个 `row_language_settings_lang_*` 行:`android:layout_height="@dimen/toolbar_height"` → 新增 `@dimen/settings_row_height`(56dp);分割线 `View` 的 `android:background="?attr/colorSurfaceVariant"` → 改为 `?attr/colorOutlineVariant`(或直接映射 `@color/divider`)并加左右 margin 对齐 840dp 容器;给每个 `row_*` 增加选中态背景(`android:background` 换成 `selector`,见下方新增 drawable) |
|
||||
| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java` | 补充选中行的背景/文字色切换逻辑(当前很可能只切 `RadioButton.setChecked`,需要联动整行 `LinearLayout` 的 `isSelected` 状态) |
|
||||
| 工具类 | `app/src/main/java/com/umilab/eapmanage/team/util/LanguageUtils.java` | 待 @coder 确认是否涉及選中态回填逻辑,本次不改业务逻辑,仅核对 |
|
||||
| 新增 drawable | `app/src/main/res/drawable/selector_language_row_bg.xml`(新建) | `state_selected` → `?attr/colorPrimaryContainer`;默认 → `?attr/selectableItemBackground` |
|
||||
|
||||
### 2.2 屏 2 — 选择版型
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| Layout | `app/src/main/res/layout/activity_edition_selection.xml` | 两张 `MaterialCardView`(`card_edition_selection_professional` / `card_edition_selection_custom`)的 `app:strokeColor` 当前分别写死 `?attr/colorPrimary` 和 `?attr/colorSecondary`(与选中状态无关,是本次要修的核心 Bug)→ 改为**动态 selector** 或代码控制:未选中 `?attr/colorOutlineVariant` 1dp,选中 `?attr/colorPrimary` 2dp;两张卡的 `RadioButton buttonTint` 统一为 `?attr/colorPrimary`(当前自定义卡是 `colorSecondary`,需统一) |
|
||||
| Activity | `app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java` | `onCheckedChangeListener` 回调中补充:切换卡片的 `strokeColor`(`professional`/`custom`)、`strokeWidth`、卡片 `backgroundTint`(选中态 `colorPrimaryContainer`,未选中 `colorSurface`)随选中状态联动。当前逻辑只处理了 RadioButton 的 checked,未处理视觉态 |
|
||||
| 关联类 | `app/src/main/java/com/umilab/eapmanage/team/edition/AppEdition.java`、`EditionManager.java` | 数据枚举与持久化,不涉及本次视觉改动,仅供 @coder 理解上下文 |
|
||||
|
||||
### 2.3 屏 3 — 版本信息
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| Layout | `app/src/main/res/layout/activity_version_info.xml` | 三张 `MaterialCardView` 内的 `LinearLayout(horizontal)` 标签列 `android:layout_width="@dimen/dimen_120dp"` → 统一改为新增 Token `@dimen/settings_form_label_width`(140dp),三卡共用同一 dimen 保证列对齐;`tv_version_info_build_type` 的 `android:textColor="?attr/colorError"` 纯红字 → 改为徽章样式(背景 `shape_badge_error.xml` + padding),文字色不变;升级卡内按钮 `btn_version_info_check_or_update` 外层补一层 `View` 分割线 + 顶部 margin,做出"动作行"效果 |
|
||||
| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.java` | 补充按钮容器分割线的显隐逻辑(若沿用现有 XML 静态分割线则无需改代码) |
|
||||
| ViewModel | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.java` | 不涉及视觉改动,仅核对状态字段(检查中/已最新/有更新/下载中/失败)是否已有对应 LiveData,供 Activity 侧驱动徽章与进度条显隐 |
|
||||
| 新增 drawable | `app/src/main/res/drawable/shape_badge_error.xml`、`shape_badge_success.xml`(新建) | 徽章背景,圆角 `@dimen/corner_radius_sm` |
|
||||
|
||||
### 2.4 屏 4 — Logo 授权管理
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| Layout | `app/src/main/res/layout/activity_logo_management.xml` | `tg_logo_mode`(`MaterialButtonToggleGroup`)内两个 `MaterialButton` 当前 `style="?attr/materialButtonOutlinedStyle"` → 新增 `Widget.EAPManage.Button.Segmented` 样式(胶囊圆角 + 选中态 `colorPrimaryContainer`/`colorOnPrimaryContainer`);文本/图片模式内的预览卡 `MaterialCardView`(`app:cardCornerRadius="@dimen/radius_md"`)内部 `LinearLayout` 的 `android:background="?attr/colorSurfaceVariant"` → 改为 `?attr/colorSurface` + 卡片本身补 `app:strokeColor="?attr/colorOutlineVariant"` `app:strokeWidth="@dimen/dimen_1dp"`;`til_custom_text` 的 `app:counterEnabled` 计数器默认样式已由 M3 TextInputLayout 承担(位置在框下方),**基本符合 DESIGN_SPEC 要求,核实实际渲染位置是否与截图一致**,若组件默认渲染已经在下方则此项标记"确认无需改" |
|
||||
| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.java` | 分段切换时补充卡片描边/底色的联动(若靠 selector 自动处理则无需改代码) |
|
||||
| ViewModel | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.java` | 不涉及视觉改动 |
|
||||
| Repository | `app/src/main/java/com/umilab/eapmanage/team/data/repository/LogoRepository.java` | 不涉及视觉改动,仅上下文参考 |
|
||||
| 工具类 | `app/src/main/java/com/umilab/eapmanage/team/util/LogoPickerHelper.java` | 不涉及视觉改动 |
|
||||
| 复用 Layout | `app/src/main/res/layout/layout_empty_state.xml` | 图片 Logo 空态直接复用该已有空态布局(`tv_logo_management_logo_empty` 已 `include` 了它),核对其内部图标/文案样式是否符合公约 §5.7 三段式,不符合则按 §5.7 微调该公共文件(**注意**:此文件可能被其他模块共用,改动前需确认无副作用,@coder 谨慎处理) |
|
||||
|
||||
### 2.5 屏 5 — 数据上传
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| Layout | `app/src/main/res/layout/activity_data_upload.xml` | **核心修复**:内层 `androidx.constraintlayout.widget.ConstraintLayout` 改写为 `LinearLayout(vertical)`,四行(自动上传开关 / 表单地址 / 原始数据地址 / 端口)改写为四个横向 `LinearLayout(gravity=center_vertical)`,每行左侧标签 `TextView(width=@dimen/settings_form_label_width)` + 右侧输入控件 `weight=1`;删除现有互相错位的 `layout_constraintTop_toBottomOf`/`Bottom_toBottomOf` 链;三个 `TextInputLayout` 上残留的无效 `android:layout_weight="1"`(ConstraintLayout 中不生效)一并清理;`androidx.appcompat.widget.SwitchCompat`(`sw_upload_auto`)→ 替换为 `com.google.android.material.materialswitch.MaterialSwitch` |
|
||||
| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/upload/DataUploadActivity.java` | 因 `id` 全部保留(`et_upload_form_url`/`et_upload_json_url`/`et_upload_port`/`sw_upload_auto`/`btn_user_save`/`btn_data_upload_reset`/`btn_data_upload_test`),View Binding 引用**不受结构调整影响**,理论上无需改代码;仅需核对"自动上传关闭 → 三输入框 alpha 0.38 且禁用"的联动是否已实现,若未实现需按 DESIGN_SPEC §3.5 状态机补充 |
|
||||
|
||||
### 2.6 全局资源文件
|
||||
|
||||
| 类型 | 路径 | 改动点 |
|
||||
| --- | --- | --- |
|
||||
| dimens | `app/src/main/res/values/dimens.xml` | 新增:`content_max_width`(840dp)、`settings_form_label_width`(140dp)、`settings_row_height`(56dp)。**不新增**与 `spacing_xl` 同值的 gutter Token(直接复用) |
|
||||
| colors | `app/src/main/res/values/colors.xml` | 核对 `color_secondary_container` 实际取值是否为浅绿(`#E0F2F1` 系),如已是 M3 默认紫需要新增/校正 |
|
||||
| styles | `app/src/main/res/values/themes.xml` | 新增 `Widget.EAPManage.Button.Segmented`(Logo 分段控件选中态样式);`Widget.EAPManage.Toolbar` 补充 `titleTextAppearance` 显式引用 `@dimen/text_size_headline` |
|
||||
| 响应式限定符 | `app/src/main/res/values-w600dp/`(**已存在但为空目录**)、`app/src/main/res/layout-w600dp/`(**已存在但为空目录**) | ★ 840dp 容器规范落地的推荐路径:在 `values-w600dp/dimens.xml` 中覆写内容 padding 相关 Token 为宽屏取值,或在 `layout-w600dp/` 下为 5 个 activity 提供宽屏专用布局变体(外层多一层 840dp 居中容器)。**待 @coder 决策**采用"运行时用代码设置 maxWidth"还是"资源限定符切两套布局",两种方案在 5 个 layout 中一致处理 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 关键实现难点与建议方案
|
||||
|
||||
### 3.1 840dp 居中容器的两种落地方式
|
||||
|
||||
| 方案 | 做法 | 优劣 |
|
||||
| --- | --- | --- |
|
||||
| A. 资源限定符 | `layout-w600dp/activity_xxx.xml` 中给内容区套一层 `maxWidth=840dp` 的容器 | 与项目已有空 `layout-w600dp/` 目录意图吻合;但 5 个文件要维护两份,维护成本高 |
|
||||
| B. 自定义 `MaxWidthLinearLayout`/`MaxWidthConstraintLayout` | 写一个继承 `LinearLayout` 的容器 View,`onMeasure` 里钳制最大宽度后居中 | 只需在默认 layout 里换一个自定义 ViewGroup 标签,无需维护双份布局,跨模块可复用 |
|
||||
|
||||
**建议**:采用方案 B,新增 `com.umilab.eapmanage.team.ui.widget.MaxWidthFrameLayout`(或类似命名),5 屏统一用它包裹内容区。此类不在本次检索范围内确认是否已存在,**待 @coder 确认**:检索关键字 `MaxWidth`、`CenteredContainer`。若已存在同类容器则直接复用,避免重复造轮子。
|
||||
|
||||
### 3.2 语言设置"通栏可点 + 视觉居中"的矛盾
|
||||
|
||||
若采用方案 B 的 MaxWidth 容器包裹每一**行**,涟漪效果会被限制在 840dp 内,宽屏下点击行两侧空白区域无反馈,与 DESIGN_SPEC §1.4 的要求(列表本体通栏、内容居中)冲突。
|
||||
**建议**:`row_language_settings_lang_*` 的 `LinearLayout` 本身保持 `match_parent` 承载点击与涟漪,内部再套一层 840dp 居中的 `LinearLayout` 只包文字和 RadioButton。即"外层可点通栏,内层视觉居中",与 `baseline_ui.html` 中 `.lang-row` / `.lang-row-inner` 的双层结构完全对应。
|
||||
|
||||
### 3.3 版型卡描边颜色的动态切换
|
||||
|
||||
`MaterialCardView` 的 `app:strokeColor` 不支持直接写 `selector`(部分 M3 版本支持 ColorStateList,需验证当前依赖的 Material Components 版本)。若不支持,只能在 `EditionSelectionActivity.java` 的 `onCheckedChangeListener` 回调中用代码 `card.setStrokeColor(...)`、`card.setStrokeWidth(...)`、`card.setCardBackgroundColor(...)` 显式设置,这是**必须改代码**的一项,不能只靠 XML。
|
||||
|
||||
---
|
||||
|
||||
## 4. 风险与待确认项(禁止编造,如下均需 @coder 或 UI 组二次确认)
|
||||
|
||||
1. **字号 Token 冲突**(§1.3):公约 §3 的 15sp 正文 / 13sp 辅助说明,与仓库现有 `dimens.xml` 的 14sp/11sp 不一致,需与其他并行 UI 子任务对齐后再定新 Token,避免重复定义。
|
||||
2. **`radius_lg` 命名歧义**:`dimens.xml` 中同时存在 `radius_lg`(12dp,用于版型卡圆角) 与语义应为 20dp 的公约 `corner_radius_lg`(实际也已存在,20dp),两者数值不同但命名相似,容易在 XML 中引用错。@coder 落地时需明确:版型卡沿用现有 `radius_lg`(12dp,对应公约的 `corner-md`),不要误用 20dp 的 `corner_radius_lg`。
|
||||
3. **`color_secondary_container` 实际取值**:未在本次检索中读取 `colors.xml` 完整内容确认该值是否已是浅绿,需 @coder 核实(检索关键字:`color_secondary_container`)。
|
||||
4. **`MaxWidthXxxLayout` 自定义容器是否已存在**:检索关键字 `MaxWidth`、`CenteredContainer`、`widget`包下的自定义 ViewGroup,本次未做穷尽检索。
|
||||
5. **Material Components 版本对 `strokeColor` ColorStateList 的支持情况**:需 @coder 查看 `app/build.gradle` 中 `com.google.android.material:material` 版本号后确认,本次未检索 build.gradle。
|
||||
6. **`values-w600dp/` / `layout-w600dp/` 现为空目录**:是否有其他并行模块已计划使用这两个目录,需要与其他 7 个子任务协调,避免资源限定符策略打架。
|
||||