# 语言设置页面 — 视觉边界手册 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` 事件。