UI 视觉设计 / 系统课时
审查旧版组件的迁移问题
审查旧版组件的迁移问题
旧版页面替换成 Material Design 3 组件后,导航高度、主题色角色、按钮形状和交互状态都可能改变。本篇以任务管理页为例,建立旧版与新版的差异清单,找出影响操作的回归问题,并形成可以交给工程团队逐项验证的验收条件。
学习目标
- 识别旧主题、导航和按钮迁移中不能直接照搬的属性。
- 用实际尺寸、语义状态和触控标准评估迁移风险。
- 输出可复查的组件差异清单与页面验收结果。
固定对照基线
以 Android Jetpack Compose 的 Material 2 迁移到标准 Material 3 为例;下文尺寸不直接套用于 M3 Expressive、Flutter 或 Android Views 的其他样式。
- 选取「今日任务」「编辑任务」「设置」三页,覆盖三个底部导航目的地、保存按钮、开关和操作反馈。
- 在 Figma 中复制旧版画板,分别标为「旧版基线」和「M3 候选」;两边保持 360dp 宽、相同文字与任务数据。
- 为浅色、深色各保留一组对照,记录组件来源、颜色角色、文字样式、可见尺寸和交互状态。
差异单至少保留「旧组件或令牌」「新组件或令牌」「影响页面」「实测结果」「处理人」五列。如果旧页面存在局部手工改色或改高,先登记覆盖值,不能仅凭组件库默认值推断最终效果。
排查主题令牌错配
Material 2 的色彩和字体分组不能当作 Material 3 的一一同值替换。设计与工程需要共同核对以下关系:
| 旧版检查点 | Material 3 检查点 | 常见迁移错误 |
|---|---|---|
MaterialTheme.colors.primary |
MaterialTheme.colorScheme.primary |
直接沿用旧色值,忽略新色调体系 |
surface、background |
surface 及适用的 surfaceContainer 角色 |
所有容器仍铺同一底色,层次消失 |
ContentAlpha.medium |
按用途检查 onSurfaceVariant |
继续用统一透明度处理全部次要文字 |
typography.h6、typography.button |
从 titleLarge、labelLarge 开始核对 |
只改样式名称,不检查行高与换行 |
这些是审查起点,不是保证视觉相同的机械映射。先依据品牌源色生成 M3 色板,再让 Figma 组件引用语义令牌,工程侧对应检查浅色与深色 ColorScheme。
例如,分别检查任务卡标题、辅助说明和保存按钮文字的前景与背景。以 WCAG AA 为验收基线,常规文字对比度至少 4.5:1,大号文字至少 3:1。不能因为旧版某个灰色值看起来接近新版,就跳过角色与对比度检查。
核对导航与按钮几何变化
| 对照项 | Material 2 常见基线 | 标准 Material 3 审查值 |
|---|---|---|
| 底部导航 | BottomNavigation,56dp 高 |
NavigationBar,80dp 高 |
| 当前导航项 | 旧版选中图标及标签样式 | 检查 NavigationBarItem 选中指示背景与标签 |
| 普通按钮 | 可见高度约 36dp | 标准小按钮可见高度约 40dp |
| 可交互目标 | 不能只看图标可见大小 | 至少 48×48dp 的触控区域 |
在同样的窗口与系统内边距条件下,导航从 56dp 增加到 80dp,会让可用内容高度减少 24dp。检查任务列表最后一项、悬浮操作入口和 Snackbar 是否被底栏遮挡;不要简单把旧画板中的导航容器拉高而不调整内容区域。

这里的 80dp 与 40dp 是所述标准组件的审查基线,不应覆盖具体库版本的实测值。例如采用 M3 Expressive 导航样式时,高度可能不同,必须单独登记使用的版本与组件样式。
检查交互状态是否遗漏
用「保存任务」走一遍完整操作,而不是只比较默认态截图:
- 默认与按下:主按钮保持明确的操作标签,按下立即提供状态层或水波纹反馈,键盘焦点必须可见。
- 提交中:模拟接口耗时 1.2 秒,按钮显示「保存中」并阻止重复提交。进度反馈属于产品交互设计,不能假定换成 M3 按钮后自动具备。
- 成功与失败:成功显示可理解的结果并更新任务;失败保留输入,显示错误说明和重试入口,不能只让按钮恢复原色。
- 禁用与导航选中:禁用按钮不响应操作;当前导航项同时具备视觉标记和选中语义,不能只依赖颜色变化。
审查时分别使用触控、键盘和 TalkBack 验证。特别注意禁用按钮是否仍像可点击控件,以及只有图标的按钮是否具备可朗读名称。对于自定义组件,还需检查状态语义是否传递给无障碍服务。
按页面验收并记录修复
至少使用 360dp 和 720dp 窗口,在浅色、深色以及系统字体放大至 200% 的情况下回归三页。验收时逐项检查:
- 三个导航目的地均可正确抵达,选中状态与实际页面一致。
- 触控目标不小于 48×48dp,且相邻操作不会产生明显误触。
- 页面正文不被底部导航遮挡,按钮标签和任务标题没有裁切。
- 保存失败后保留编辑内容,并能再次提交。
- 文本对比度满足既定标准,键盘焦点与 TalkBack 操作顺序正确。
将问题按影响排序:无法切换页面或丢失用户输入属于阻断问题;触控区域不足、焦点缺失和对比度不合格属于必须修复的问题;不影响操作的细微圆角差异再依据设计规范处理。
每条问题记录旧版与新版截图、对应令牌、复现条件、责任人和复测结论。工程组件名称及主题迁移关系可对照 Android 官方 Material 2 至 Material 3 迁移指南。只有主题、布局和交互状态都通过复测,才将该页面标记为迁移完成。