已优化语言设置页面UI

This commit is contained in:
zhy200308
2026-08-17 14:51:41 +08:00
parent cc6b6c54aa
commit 0c7e12f89a
28 changed files with 2619 additions and 23 deletions
@@ -0,0 +1,56 @@
---
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 硬编码。
@@ -0,0 +1,69 @@
# 语言设置页面 — 视觉边界手册 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` 事件。
Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

@@ -0,0 +1,503 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>EAPManageUI - 语言设置 (UI 重构基准)</title>
<style>
/* =========================================================================
:root 全量 Design Tokens 声明 (严格遵循 Material 3 / 系统设置设计规范)
HTML 内禁止散落硬编码色值,一律引用 var(--*)
========================================================================= */
:root {
/* ── 核心主题色 ── */
--color-primary: #3949AB;
--color-on-primary: #FFFFFF;
--color-primary-container: #EEF2FF;
--color-on-primary-container: #1A237E;
--color-primary-hover: rgba(57, 73, 171, 0.04);
--color-primary-glow: rgba(57, 73, 171, 0.12);
/* ── 表面与背景 ── */
--color-surface: #FFFFFF;
--color-surface-variant: #F8FAFC;
--color-background: #F1F5F9;
/* ── 文本语义色 ── */
--text-primary: #0F172A;
--text-secondary: #64748B;
--text-tertiary: #94A3B8;
--text-disabled: #CBD5E1;
/* ── 边框与分割线 ── */
--divider: #E2E8F0;
--outline: #CBD5E1;
--outline-focused: #3949AB;
/* ── 圆角阶梯 ── */
--corner-sm: 8px;
--corner-md: 12px;
--corner-lg: 16px;
--corner-pill: 999px;
/* ── 阴影阶梯 ── */
--shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.04);
--shadow-md: 0 4px 16px -2px rgba(15, 23, 42, 0.06);
--shadow-lg: 0 12px 32px -4px rgba(15, 23, 42, 0.08);
/* ── 间距规范 ── */
--spacing-xs: 4px;
--spacing-sm: 8px;
--spacing-md: 16px;
--spacing-lg: 24px;
--spacing-xl: 32px;
/* ── 字号与行高阶梯 ── */
--font-title: 20px;
--font-subtitle: 16px;
--font-body: 15px;
--font-caption: 13px;
--font-badge: 12px;
/* ── 尺寸与栅格 ── */
--content-max-width: 920px;
--content-gutter: 24px;
--appbar-height: 60px;
--row-height: 54px;
--touch-min: 48px;
--sidebar-width: 280px;
}
/* =========================================================================
基础排版与重置
========================================================================= */
* {
box-sizing: border-box;
margin: 0;
padding: 0;
}
html {
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
"PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
font-size: var(--font-body);
color: var(--text-primary);
background: var(--color-background);
min-height: 100vh;
padding: var(--spacing-lg);
font-variant-numeric: tabular-nums;
}
/* =========================================================================
平板视口容器模拟 (模拟 Android 10~14 英寸宽屏)
========================================================================= */
.screen-container {
width: 100%;
max-width: 1080px;
margin: 0 auto;
background: var(--color-surface);
border-radius: var(--corner-lg);
border: 1px solid var(--divider);
box-shadow: var(--shadow-lg);
overflow: hidden;
display: flex;
flex-direction: column;
min-height: 640px;
}
/* =========================================================================
AppBar 顶部栏规范
========================================================================= */
.appbar {
height: var(--appbar-height);
display: flex;
align-items: center;
padding: 0 var(--spacing-lg);
background: var(--color-surface);
border-bottom: 1px solid var(--divider);
flex-shrink: 0;
}
.appbar-nav {
width: var(--touch-min);
height: var(--touch-min);
display: inline-flex;
align-items: center;
justify-content: center;
border-radius: var(--corner-md);
cursor: pointer;
background: var(--color-surface-variant);
border: 1px solid var(--divider);
transition: all 0.15s ease;
margin-left: -4px;
}
.appbar-nav:hover {
background: #E2E8F0;
transform: scale(0.98);
}
.appbar-nav svg {
width: 22px;
height: 22px;
fill: var(--text-primary);
}
.appbar-title {
font-size: var(--font-title);
font-weight: 600;
color: var(--text-primary);
margin-left: var(--spacing-md);
letter-spacing: -0.2px;
}
/* =========================================================================
Master-Detail 双栏主体排版
========================================================================= */
.page-body {
flex: 1;
padding: var(--spacing-xl) var(--content-gutter);
background: var(--color-background);
display: flex;
justify-content: center;
align-items: flex-start;
}
.master-detail-layout {
width: 100%;
max-width: var(--content-max-width);
display: flex;
gap: var(--spacing-lg);
align-items: stretch;
}
/* ── 左侧面板:语言状态与概览 (Master/Summary Panel) ── */
.summary-sidebar {
flex: 0 0 var(--sidebar-width);
background: var(--color-surface);
border-radius: var(--corner-lg);
border: 1px solid var(--divider);
box-shadow: var(--shadow-sm);
padding: var(--spacing-lg);
display: flex;
flex-direction: column;
}
.sidebar-icon-wrap {
width: 52px;
height: 52px;
border-radius: var(--corner-md);
background: var(--color-primary-container);
display: flex;
align-items: center;
justify-content: center;
margin-bottom: var(--spacing-md);
}
.sidebar-icon-wrap svg {
width: 28px;
height: 28px;
fill: var(--color-primary);
}
.sidebar-title {
font-size: var(--font-subtitle);
font-weight: 600;
color: var(--text-primary);
margin-bottom: var(--spacing-xs);
}
.sidebar-desc {
font-size: var(--font-caption);
line-height: 1.5;
color: var(--text-secondary);
margin-bottom: var(--spacing-lg);
}
.curr-status-card {
margin-top: auto;
background: var(--color-surface-variant);
border: 1px solid var(--divider);
border-radius: var(--corner-md);
padding: var(--spacing-md);
}
.curr-status-label {
font-size: var(--font-badge);
font-weight: 500;
color: var(--text-secondary);
text-transform: uppercase;
letter-spacing: 0.5px;
margin-bottom: var(--spacing-xs);
}
.curr-status-value {
font-size: 18px;
font-weight: 700;
color: var(--color-primary);
display: flex;
align-items: center;
gap: 8px;
}
.curr-status-dot {
width: 8px;
height: 8px;
border-radius: 50%;
background: #10B981;
}
/* ── 右侧面板:语言选择列表 (Detail/Selection Panel) ── */
.selection-card {
flex: 1;
background: var(--color-surface);
border-radius: var(--corner-lg);
border: 1px solid var(--divider);
box-shadow: var(--shadow-sm);
overflow: hidden;
}
.lang-list {
width: 100%;
}
.lang-row {
height: var(--row-height);
display: flex;
align-items: center;
justify-content: space-between;
padding: 0 var(--spacing-lg);
cursor: pointer;
border-bottom: 1px solid var(--divider);
background: transparent;
transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
position: relative;
user-select: none;
}
.lang-row:last-child {
border-bottom: none;
}
.lang-row:hover {
background: var(--color-primary-hover);
}
.lang-row.is-selected {
background: var(--color-primary-container);
}
.lang-name-group {
display: flex;
align-items: center;
gap: 12px;
}
.lang-active-indicator {
width: 4px;
height: 20px;
border-radius: 2px;
background: var(--color-primary);
opacity: 0;
transform: scaleY(0.4);
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
}
.lang-row.is-selected .lang-active-indicator {
opacity: 1;
transform: scaleY(1);
}
.lang-name {
font-size: var(--font-body);
font-weight: 450;
color: var(--text-primary);
letter-spacing: 0.1px;
}
.lang-row.is-selected .lang-name {
color: var(--color-on-primary-container);
font-weight: 600;
}
/* ── Radio 单选按钮控件 ── */
.radio-box {
width: 22px;
height: 22px;
border-radius: 50%;
border: 2px solid var(--outline);
display: flex;
align-items: center;
justify-content: center;
background: var(--color-surface);
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
flex-shrink: 0;
}
.lang-row.is-selected .radio-box {
border-color: var(--color-primary);
}
.radio-dot {
width: 10px;
height: 10px;
border-radius: 50%;
background: var(--color-primary);
opacity: 0;
transform: scale(0.3);
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
}
.lang-row.is-selected .radio-dot {
opacity: 1;
transform: scale(1);
}
/* =========================================================================
响应式断点 (平板竖屏 / 窄屏收敛)
========================================================================= */
@media (max-width: 768px) {
.master-detail-layout {
flex-direction: column;
}
.summary-sidebar {
flex: none;
width: 100%;
}
}
</style>
</head>
<body>
<div class="screen-container">
<!-- 顶部导航栏 AppBar -->
<header class="appbar">
<div class="appbar-nav" title="返回">
<svg viewBox="0 0 24 24"><path d="M20 11H7.83l5.59-5.59L12 4l-8 8 8 8 1.41-1.41L7.83 13H20v-2z"/></svg>
</div>
<h1 class="appbar-title">语言设置</h1>
</header>
<!-- 主体双栏内容区 -->
<main class="page-body">
<div class="master-detail-layout">
<!-- 左侧状态概览面板 -->
<aside class="summary-sidebar">
<div class="sidebar-icon-wrap">
<svg viewBox="0 0 24 24"><path d="M12.87 15.07l-2.54-2.51.03-.08c1.74-1.94 2.98-4.17 3.71-6.49H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"/></svg>
</div>
<h2 class="sidebar-title">系统显示语言</h2>
<p class="sidebar-desc">选择后即时应用到系统所有界面与交互提示。</p>
<div class="curr-status-card">
<div class="curr-status-label">当前选定语言</div>
<div class="curr-status-value">
<span class="curr-status-dot"></span>
<span id="currLangLabel">中文</span>
</div>
</div>
</aside>
<!-- 右侧全量 9 个语言单选列表 (字段与原图 100% 一致) -->
<section class="selection-card">
<div class="lang-list" id="langList">
<div class="lang-row" onclick="selectLang(this, 'English')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">English</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, 'Français')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">Français</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row is-selected" onclick="selectLang(this, '中文')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">中文</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, '日本語')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">日本語</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, '한국어')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">한국어</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, 'Español')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">Español</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, 'Italiano')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">Italiano</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, 'Ελληνικά')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">Ελληνικά</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
<div class="lang-row" onclick="selectLang(this, 'Português')">
<div class="lang-name-group">
<div class="lang-active-indicator"></div>
<span class="lang-name">Português</span>
</div>
<div class="radio-box"><div class="radio-dot"></div></div>
</div>
</div>
</section>
</div>
</main>
</div>
<script>
function selectLang(rowEl, langName) {
document.querySelectorAll('.lang-row').forEach(row => {
row.classList.remove('is-selected');
});
rowEl.classList.add('is-selected');
const labelEl = document.getElementById('currLangLabel');
if (labelEl) {
labelEl.innerText = langName;
}
}
</script>
</body>
</html>
@@ -0,0 +1,88 @@
# 语言设置页面 — 原生落地图纸 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
<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` 状态联动
- 用户点击右侧任一语言项时,执行原有的语言切换逻辑,并即时更新:
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。