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

57 lines
3.1 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.
---
title: "APP界面优化 - 语言设置页面 (Language Settings)"
status: "TODO"
created: "2026-08-17"
level: 1
---
# 任务目标
对系统设置子页面【语言设置】执行 UI 交互与视觉重构(**严格纯美化,禁止修改/增删字段**)。
核心解决平板横屏下单列拉伸过宽、信息架构单薄的痛点,升级为 **Split Master-Detail 宽屏沉浸双栏架构**(左侧状态摘要面板 + 右侧 16dp 圆角语言选择卡片),同时提供清晰的行级选中高亮与状态实时联动。
---
## 🛠️ 开发依据(标准物料约束)
> 🚨 **绝对约束**:请 `@coder` 在修改代码前,**必须**完整阅读本工作台目录下的全部物料,严禁自行发挥排版!
>
> **工作台路径**:`设置页面UI优化/语言设置/`
> 1. `baseline_ui.html`:**[必读]** 终极 HTML/CSS 排版基准源代码(双栏布局、选中态、状态联动、Token 声明)。
> 2. `DESIGN_SPEC.md`:**[必读]** 视觉边界手册(双栏尺寸、行高、选中态、圆角阴影、断点规则)。
> 3. `implementation_plan.md`:**[必读]** CSS → Android Token 映射字典与原生代码落地清单。
>
> **原始出厂截屏**(信息字段保底凭证,只读):
> - `Screenshot_20260812_143341.png`
---
## 📂 涉及文件清单
**1. Layout**
- `app/src/main/res/layout/activity_language_settings.xml`
**2. Java / Activity / Utils**
- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java`
- `app/src/main/java/com/umilab/eapmanage/team/util/LanguageUtils.java`
**3. 资源与样式 (Resources & Drawables)**
- `app/src/main/res/drawable/selector_language_row_bg.xml`(新建)
- `app/src/main/res/drawable/shape_language_card_bg.xml`(新建)
- `app/src/main/res/values/dimens.xml`(核对/补充 `settings_sidebar_width`、`settings_row_height`)
---
## 📋 执行步骤清单
1. **重构布局结构**:将 `activity_language_settings.xml` 改为 AppBar + 居中 920dp 水平双栏容器(左侧 280dp 概览面板,右侧自适应卡片列表)。
2. **右侧 9 个语言行重构**:逐行应用 `54dp` 行高、文字与 RadioButton 布局、左侧 4dp 主色指示条。
3. **行级背景与状态机绑定**:使用 `selector_language_row_bg.xml`,选中态展示 `colorPrimaryContainer` 浅蓝底 + 深色文字。
4. **左侧当前语言状态联动**:在 `LanguageSettingsActivity.java` 中将点击事件与左侧 `tv_current_selected_language` 文本实现实时刷新。
5. **字段核验**:确保 `English`, `Français`, `中文`, `日本語`, `한국어`, `Español`, `Italiano`, `Ελληνικά`, `Português` 全量 9 个字段完整无误。
---
## ✅ 验收标准
- [ ] 平板横屏下展示为居中双栏布局,视觉平衡饱满,无单调过宽留白。
- [ ] 原始 9 个语言选项字段 100% 对应原图,无任何拼写/增删改动。
- [ ] 点击语言项,整行选中背景、指示条、Radio 动画及左侧状态卡片文字同步联动。
- [ ] 所有颜色与尺寸严格使用 Android 语义 Token,无任何 XML 硬编码。