Files
EAP_Interface_html/设置页面UI优化/版型切换/DESIGN_SPEC.md
T

64 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 选择版型页面 — 视觉边界手册 DESIGN_SPEC
- **模块**:系统设置子页面 — 选择版型 / 版型切换 (`EditionSelectionActivity`)
- **日期**:2026-08-17
- **视觉基准**:同目录 `baseline_ui.html`(Split Studio 双栏专业控制台架构)
- **原始出厂截图**(只读引用):`./Screenshot_20260812_143347.png`
> **铁律复述**:本次重构为纯 UI 视觉升级与描边逻辑修复。全量字段名、描述文本、Icon 图标及按钮交互全部 100% 保留,严禁篡改任何业务字段。
---
## 1. 宽屏平板布局架构 (Split Master-Detail 栅格规范)
### 1.1 现状缺陷剖析
1. **描边逻辑颠倒 Bug**:原截图 `Screenshot_20260812_143347.png` 中,“专业版(未选中)”硬编码为蓝框,“自定义功能版(已选中)”硬编码为绿框,描边与卡片身份绑死,严重误导用户。
2. **超宽拉伸失衡**:在 16:10 / 16:9 横屏平板下,单列卡片横跨整个屏幕,文字空旷,视觉焦点极度涣散。
### 1.2 目标架构规范 (Split Studio 双栏控制台)
| 规范项 | 参数值 | 说明 |
| :--- | :--- | :--- |
| **容器最大宽度** | **1160dp** (`--content-max-width`) | 超出宽度时屏幕左右自动居中留白 (`margin: 0 auto`) |
| **外层动态边距** | **`clamp(16px, 2.5vw, 32px)`** | 全局自适应外层页边距,大屏小屏上下左右等距呼吸 |
| **左侧概览岛屿** | **固定 360dp** (`--sidebar-width`) | 包含原版红框 3 柱状图图标、大标题“选择版型”、说明副文本、当前选定版型状态卡片 |
| **右侧卡片选择区** | **自适应 1fr** (`grid-template-columns: 360dp 1fr`) | 纵向排布两张版型卡片 + 底部确定按钮,与语言设置 100% 统一比例 |
| **AppBar 顶部栏** | **通栏 60dp** (`--appbar-height`) | 标题 19sp/700,40dp 纯净透明圆形触控槽 |
---
## 2. 字段与槽位核验清单 (100% 对齐原图)
| # | 区域 | 字段 / 元素标识 | 初始状态 / 规范 |
| :-: | :--- | :--- | :--- |
| 1 | **AppBar** | 返回箭头 `(←)` | 48dp 触控槽,点击返回上一级 |
| 2 | **AppBar** | `选择版型` | 20sp / 600 字重 / `--text-primary` |
| 3 | **Hero 引导** | 红框柱状图图标 | 52dp 尺寸,原版红框 `#FF5252`,内含 3 根垂直条 |
| 4 | **Hero 引导** | `选择版型` | 21sp / 700 字重 / `--text-primary` |
| 5 | **Hero 引导** | `请选择适合您使用场景的版型,后续可在设置中更改` | 13.5sp / `--text-secondary` / 1.6 行高 |
| 6 | **卡片 1** | 单选 Radio 钮 | 未选中态(空心圆圈) |
| 7 | **卡片 1** | `专业版` | 17.5sp / 700 字重 |
| 8 | **卡片 1** | `为专业场馆管理员设计,布局固定专业化,核心数据字段默认全开,开箱即用` | 13.8sp / `--text-secondary` |
| 9 | **卡片 2** | 单选 Radio 钮 | **默认选中态**(实心圆点) |
| 10 | **卡片 2** | `自定义功能版` | 17.5sp / 700 字重 |
| 11 | **卡片 2** | `高度可配置,所有高级功能开放,适合研究员和高级用户` | 13.8sp / `--text-secondary` |
| 12 | **动作区** | `确定` 按钮 | 浅绿底 `--color-secondary-container` + 绿字 `--color-secondary`,48dp 高,12dp 圆角 |
---
## 3. 状态机与交互规范
### 3.1 卡片状态机 (彻底纠正原图颠倒逻辑)
| 状态 | 描边 (Border) | 背景色 | 左侧 Active 指示条 | RadioButton | 投影 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **未选中 (Unselected)** | `1.5dp --divider` (`#E2E8F0`) | `#FFFFFF` | `opacity: 0` | 2dp `#CBD5E1` 空心圈 | Level 1 |
| **悬停 (Hover)** | `1.5dp #94A3B8` | `#F8FAFC` | `opacity: 0` | 不变 | Level 2 |
| **选中态 (Selected)** | `1.5dp --color-primary` (`#3949AB`) | `--color-primary-container` (`#EEF2FF`) | `opacity: 1; scaleY: 1` (`#3949AB`) | 2dp `#3949AB` 圈 + 10dp 实心蓝点 | Level 2 + 蓝光 |
| **点击 (Pressed)** | 保持 | 略微加深 4% | 保持 | 触发缩放涟漪 | Level 1 |
### 3.2 左右状态联动
- 当用户点击右侧任一版型卡片时:
1. 当前卡片获得选中态,另一张卡片恢复未选中态;
2. 左侧侧边栏底部的「当前选定版型」文案即时联动刷新(如“自定义功能版” $\leftrightarrow$ “专业版”)。