已优化语言设置页面UI

This commit is contained in:
zhy200308
2026-08-17 14:51:41 +08:00
parent cc6b6c54aa
commit 0c7e12f89a
28 changed files with 2619 additions and 23 deletions
@@ -0,0 +1,69 @@
# 语言设置页面 — 视觉边界手册 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 双栏沉浸分栏)
| 规范项 | 参数值 | 说明 |
| :--- | :--- | :--- |
| **内容容器最大宽度** | **920dp** (`--content-max-width`) | 超出宽度时屏幕左右自动居中留白 (`margin: 0 auto`) |
| **左右安全边距** | **24dp** (`--content-gutter`) | 视口 < 920dp 时生效的安全呼吸衬距 |
| **左侧概览面板 (Master)** | **固定 280dp** (`--sidebar-width`) | 包含图标、标题“系统显示语言”、说明文案、当前选定语言状态卡片(带高亮绿点) |
| **右侧列表卡片 (Detail)** | **自适应 1fr** (~616dp) | 包裹 9 个语言项的纯白圆角卡片,`border-radius: 16dp`,`border: 1px solid #E2E8F0` |
| **AppBar 顶部栏** | **通栏 60dp** (`--appbar-height`) | 标题 20sp/600,返回箭头 48dp 触控槽,左边界光学对齐 16dp |
| **单行列表高度** | **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` 事件。