已优化语言设置页面UI
|
After Width: | Height: | Size: 141 KiB |
|
After Width: | Height: | Size: 96 KiB |
|
After Width: | Height: | Size: 212 KiB |
|
After Width: | Height: | Size: 191 KiB |
|
After Width: | Height: | Size: 84 KiB |
|
After Width: | Height: | Size: 123 KiB |
|
After Width: | Height: | Size: 142 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
After Width: | Height: | Size: 196 KiB |
|
After Width: | Height: | Size: 215 KiB |
@@ -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` 事件。
|
||||
|
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。
|
||||