Files
EAP_Interface_html/设置页面UI优化/语言设置/DESIGN_SPEC.md
T

70 lines
4.4 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
- **模块**:系统设置类子页面 — 语言设置 (Language Settings)
- **日期**:2026-08-17
- **视觉基准**:同目录 `baseline_ui.html`(双栏 Master-Detail 架构,单文件双击浏览器可开)
- **原始出厂截图**(只读引用,绝对不可重命名):
`./Screenshot_20260812_143341.png`
> **铁律复述**:本次重构为纯 UI 交互与视觉升级。全量 9 个语种字段名、顺序、AppBar 标题及交互逻辑全部原样保留,严禁擅自增删或修改任何字段。
---
## 1. 宽屏平板布局架构 (Split Master-Detail 栅格规范)
### 1.1 现状问题分析
- 原始截图(`Screenshot_20260812_143341.png`)在平板横屏(16:10 / 16:9 宽屏)下,9 个单选项单调拉伸,右侧 RadioButton 距离左侧文字超过 1000dp,视线跨度过大。
- 选中的“中文”仅有一个蓝色 Radio 小圆点,整行无底色或焦点反馈,大屏下极易误触或丢失焦点感知。
### 1.2 目标架构规范 (方案 4 双栏沉浸分栏)
| 规范项 | 参数值 | 说明 |
| :--- | :--- | :--- |
| **容器最大宽度** | **1160dp** (`--content-max-width`) | 超出宽度时屏幕左右自动居中留白 (`margin: 0 auto`) |
| **外层动态边距** | **`clamp(16px, 2.5vw, 32px)`** | 全局自适应外层页边距,大屏小屏上下左右等距呼吸 |
| **左侧概览岛屿** | **固定 360dp** (`--sidebar-width`) | 包含 52dp 语言图标、当前选定语言状态卡片与说明文案 |
| **右侧选择面板** | **自适应 1fr** (`grid-template-columns: 360dp 1fr`) | 单选语言列表容器,与版型切换保持 100% 统一比例 |
| **AppBar 顶部栏** | **通栏 60dp** (`--appbar-height`) | 标题 19sp/700,40dp 纯净透明圆形触控槽 |
| **单行列表高度** | **54dp** (`--row-height`) | 满足工控/平板 48dp 最小触控规范,垂直居中对齐 |
| **响应式断点** | **768dp** | `< 768dp`(竖屏/小窗分屏模式)时自动回落为单列竖向堆叠流 |
---
## 2. 字段与槽位核验清单 (100% 对齐原图)
| # | 字段标识 (原始文案) | 初始状态 | 视觉呈现与交互要求 |
| :-: | :--- | :---: | :--- |
| 1 | `English` | 未选中 | 左侧 15px 正文字体,右侧 22dp 空心 Radio 圈 |
| 2 | `Français` | 未选中 | 保持特殊字符原生渲染(带 cedilla 变音符) |
| 3 | `中文` | **默认选中** | 背景呈 `PrimaryContainer` (`#EEF2FF`) 浅蓝底,文字 `#1A237E` (600 字重),左侧 4dp Active 指示胶囊,右侧主色实心 Radio 钮 |
| 4 | `日本語` | 未选中 | 原生汉字与假名渲染 |
| 5 | `한국어` | 未选中 | 原生韩文字形渲染 |
| 6 | `Español` | 未选中 | 原生西文字形渲染(带 tilde 变音符) |
| 7 | `Italiano` | 未选中 | 原生拉丁字形渲染 |
| 8 | `Ελληνικά` | 未选中 | 原生希腊字母渲染 |
| 9 | `Português` | 未选中 | 原生葡文字形渲染(带 circumflex 变音符) |
---
## 3. 视觉与状态机规范
### 3.1 列表项状态机
| 状态 | 背景色 | 文字颜色 / 字重 | 左侧指示条 (Active Bar) | 右侧 RadioButton |
| :--- | :--- | :--- | :--- | :--- |
| **默认未选中** | `#FFFFFF` | `#0F172A` / 450 | `opacity: 0; scaleY: 0.4` | `2dp` 边框 `#CBD5E1`,内部空白 |
| **Hover 悬停** | `rgba(57, 73, 171, 0.04)` | `#0F172A` / 500 | `opacity: 0` | 边框不变 |
| **选中态 (Selected)** | `#EEF2FF` (`PrimaryContainer`) | `#1A237E` / 600 | `opacity: 1; scaleY: 1` (`#3949AB`) | 边框 `#3949AB`,内含 `10dp` 主色实心圆点 |
| **Pressed 点击瞬间** | `rgba(57, 73, 171, 0.08)` | 保持 | 触发平滑缩放动效 | 水波纹涟漪扩散 |
### 3.2 联动反馈机制
- 当用户在右侧点击任一语言项时,右侧立即切换选中行高亮。
- 左侧面板下方的 `curr-status-card` 内的「当前选定语言」文案同步平滑刷新(例如由“中文”实时变为“English”)。
---
## 4. 边界与异常情况处理
1. **超长文本兜底**:9 个内置语种名称长度均在 10 字符以内,单行不会溢出;若未来动态扩展超长语种名,需设置 `singleLine=true` + `ellipsize=end`。
2. **多语言排版字体兜底**:必须确保包含希腊字母(`Ελληνικά`)与韩文(`한국어`)字库,采用 Android 系统级 Roboto / Noto Sans 多语言字体族 fallback。
3. **触控安全区**:每行最小触控高度 $\ge 48\text{dp}$,整行全区域响应 `onClick` 事件。