# 语言设置页面 — 原生落地图纸 implementation_plan - **模块**:系统设置 — 语言设置 (`LanguageSettingsActivity`) - **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md` - **原始出厂截图**:`./Screenshot_20260812_143341.png` - **执行角色**:`@coder` (Android 工程师) --- ## 1. CSS → Android Token 映射字典 ### 1.1 颜色语义映射 | HTML CSS 变量 | 取值 | Android 语义 Token / 资源 ID | 状态 / 说明 | | :--- | :--- | :--- | :--- | | `--color-primary` | `#3949AB` | `?attr/colorPrimary` (`@color/color_primary`) | ✅ 已存在 | | `--color-on-primary` | `#FFFFFF` | `?attr/colorOnPrimary` | ✅ 已存在 | | `--color-primary-container` | `#EEF2FF` | `?attr/colorPrimaryContainer` (`@color/color_primary_container`) | ✅ 已存在,选中行底色 | | `--color-on-primary-container` | `#1A237E` | `?attr/colorOnPrimaryContainer` | ✅ 已存在,选中行主文本 | | `--color-surface` | `#FFFFFF` | `?attr/colorSurface` (`@color/color_surface`) | ✅ 已存在,卡片背景色 | | `--color-surface-variant` | `#F8FAFC` | `?attr/colorSurfaceVariant` | ✅ 已存在,左侧底色 | | `--color-background` | `#F1F5F9` | `?attr/colorBackground` (`@color/color_background`) | ✅ 已存在,页面背景 | | `--text-primary` | `#0F172A` | `@color/text_primary` | ✅ 已存在,未选中文字 | | `--text-secondary` | `#64748B` | `@color/text_secondary` | ✅ 已存在,说明副文本 | | `--divider` | `#E2E8F0` | `@color/divider` | ✅ 已存在,分割线 | | `--outline` | `#CBD5E1` | `@color/outline` | ✅ 已存在,单选空心圈 | ### 1.2 尺寸与间距 Token 映射 | HTML CSS 变量 | 取值 | Android 推荐 Token | 规范落地建议 | | :--- | :--- | :--- | :--- | | `--content-max-width` | 920px | `@dimen/content_max_width_split` (920dp) | 宽屏双栏内容容器上限 | | `--sidebar-width` | 280px | `@dimen/settings_sidebar_width` (280dp) | 左侧状态面板固定宽度 | | `--appbar-height` | 60px | `@dimen/appbar_height` (60dp 或复用 56dp) | Toolbar 高度 | | `--row-height` | 54px | `@dimen/settings_row_height` (54dp) | 语言单行高度 | | `--corner-md` | 12px | `@dimen/corner_radius_md` (12dp) | 内部组件与徽章圆角 | | `--corner-lg` | 16px | `@dimen/corner_radius_lg` (16dp) | 外层卡片大圆角 | | `--spacing-md` | 16px | `@dimen/spacing_md` (16dp) | 元素间距 | | `--spacing-lg` | 24px | `@dimen/spacing_xl` (24dp) | 双栏间距与安全衬距 | --- ## 2. Android 落地代码清单与改动指南 ### 2.1 涉及文件 1. **布局文件 (Layout)** - `app/src/main/res/layout/activity_language_settings.xml` 2. **逻辑类 (Activity / Adapter)** - `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. **新增资源 (Drawable / Selector)** - `app/src/main/res/drawable/selector_language_row_bg.xml` (选中行背景选择器) - `app/src/main/res/drawable/shape_language_card_bg.xml` (16dp 圆角白色卡片背景) --- ### 2.2 具体实施步骤 #### 步骤 1:重构 `activity_language_settings.xml` - 顶层由原本铺满的单列列表,重构为 **AppBar + 居中 920dp 水平双栏容器 (`LinearLayout horizontal`)**。 - 左侧增加 `summary-sidebar`(展示图标、标题“系统显示语言”、说明、及 `tv_current_selected_language` 状态卡片)。 - 右侧包裹 `MaterialCardView`(`cardCornerRadius="16dp"`、`cardElevation="2dp"`),内部纵向排布 9 个语言行。 #### 步骤 2:语言行条目优化 - 每个语言项 `row_language_*` 高度设为 `54dp`。 - 背景使用 `selector_language_row_bg.xml`: ```xml ``` - 选中项高亮文字为 `?attr/colorOnPrimaryContainer`,并显示左侧 4dp 主色指示条。 #### 步骤 3:`LanguageSettingsActivity.java` 状态联动 - 用户点击右侧任一语言项时,执行原有的语言切换逻辑,并即时更新: 1. 当前被选行的 `setSelected(true)`,其余行 `setSelected(false)`; 2. 左侧 `tv_current_selected_language.setText(selectedLanguageName)`。 --- ## 3. 验收核验标准 - [ ] 平板横屏下展示为居中双栏布局,无单列右侧过度空白现象。 - [ ] 9 个语种字段文案(`English`, `Français`, `中文`, `日本語`, `한국어`, `Español`, `Italiano`, `Ελληνικά`, `Português`)100% 保留无遗漏。 - [ ] 点击任一行,整行背景与 RadioButton 同步高亮,左侧当前语言状态同步更新。 - [ ] 无任何 XML 硬编码色值,全部引用 Token。