4.8 KiB
4.8 KiB
语言设置页面 — 原生落地图纸 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 涉及文件
- 布局文件 (Layout)
app/src/main/res/layout/activity_language_settings.xml
- 逻辑类 (Activity / Adapter)
app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.javaapp/src/main/java/com/umilab/eapmanage/team/util/LanguageUtils.java
- 新增资源 (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:<selector xmlns:android="http://schemas.android.com/apk/res/android"> <item android:state_selected="true" android:drawable="@color/color_primary_container" /> <item android:state_pressed="true" android:drawable="?attr/colorControlHighlight" /> <item android:drawable="@android:color/transparent" /> </selector> - 选中项高亮文字为
?attr/colorOnPrimaryContainer,并显示左侧 4dp 主色指示条。
步骤 3:LanguageSettingsActivity.java 状态联动
- 用户点击右侧任一语言项时,执行原有的语言切换逻辑,并即时更新:
- 当前被选行的
setSelected(true),其余行setSelected(false); - 左侧
tv_current_selected_language.setText(selectedLanguageName)。
- 当前被选行的
3. 验收核验标准
- 平板横屏下展示为居中双栏布局,无单列右侧过度空白现象。
- 9 个语种字段文案(
English,Français,中文,日本語,한국어,Español,Italiano,Ελληνικά,Português)100% 保留无遗漏。 - 点击任一行,整行背景与 RadioButton 同步高亮,左侧当前语言状态同步更新。
- 无任何 XML 硬编码色值,全部引用 Token。