Files
EAP_Interface_html/设置页面UI优化/语言设置/DESIGN_SPEC.md
T
2026-08-17 14:51:41 +08:00

4.5 KiB
Raw Blame History

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