UI 视觉设计 / 系统课时

审查旧版组件的迁移问题

审查旧版组件的迁移问题

旧版页面替换成 Material Design 3 组件后,导航高度、主题色角色、按钮形状和交互状态都可能改变。本篇以任务管理页为例,建立旧版与新版的差异清单,找出影响操作的回归问题,并形成可以交给工程团队逐项验证的验收条件。

学习目标

  • 识别旧主题、导航和按钮迁移中不能直接照搬的属性。
  • 用实际尺寸、语义状态和触控标准评估迁移风险。
  • 输出可复查的组件差异清单与页面验收结果。

固定对照基线

以 Android Jetpack Compose 的 Material 2 迁移到标准 Material 3 为例;下文尺寸不直接套用于 M3 Expressive、Flutter 或 Android Views 的其他样式。

  1. 选取「今日任务」「编辑任务」「设置」三页,覆盖三个底部导航目的地、保存按钮、开关和操作反馈。
  2. 在 Figma 中复制旧版画板,分别标为「旧版基线」和「M3 候选」;两边保持 360dp 宽、相同文字与任务数据。
  3. 为浅色、深色各保留一组对照,记录组件来源、颜色角色、文字样式、可见尺寸和交互状态。

差异单至少保留「旧组件或令牌」「新组件或令牌」「影响页面」「实测结果」「处理人」五列。如果旧页面存在局部手工改色或改高,先登记覆盖值,不能仅凭组件库默认值推断最终效果。

排查主题令牌错配

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 是否被底栏遮挡;不要简单把旧画板中的导航容器拉高而不调整内容区域。

旧版与 Material 3 导航、按钮及状态差异对照

这里的 80dp 与 40dp 是所述标准组件的审查基线,不应覆盖具体库版本的实测值。例如采用 M3 Expressive 导航样式时,高度可能不同,必须单独登记使用的版本与组件样式。

检查交互状态是否遗漏

用「保存任务」走一遍完整操作,而不是只比较默认态截图:

  1. 默认与按下:主按钮保持明确的操作标签,按下立即提供状态层或水波纹反馈,键盘焦点必须可见。
  2. 提交中:模拟接口耗时 1.2 秒,按钮显示「保存中」并阻止重复提交。进度反馈属于产品交互设计,不能假定换成 M3 按钮后自动具备。
  3. 成功与失败:成功显示可理解的结果并更新任务;失败保留输入,显示错误说明和重试入口,不能只让按钮恢复原色。
  4. 禁用与导航选中:禁用按钮不响应操作;当前导航项同时具备视觉标记和选中语义,不能只依赖颜色变化。

审查时分别使用触控、键盘和 TalkBack 验证。特别注意禁用按钮是否仍像可点击控件,以及只有图标的按钮是否具备可朗读名称。对于自定义组件,还需检查状态语义是否传递给无障碍服务。

按页面验收并记录修复

至少使用 360dp 和 720dp 窗口,在浅色、深色以及系统字体放大至 200% 的情况下回归三页。验收时逐项检查:

  • 三个导航目的地均可正确抵达,选中状态与实际页面一致。
  • 触控目标不小于 48×48dp,且相邻操作不会产生明显误触。
  • 页面正文不被底部导航遮挡,按钮标签和任务标题没有裁切。
  • 保存失败后保留编辑内容,并能再次提交。
  • 文本对比度满足既定标准,键盘焦点与 TalkBack 操作顺序正确。

将问题按影响排序:无法切换页面或丢失用户输入属于阻断问题;触控区域不足、焦点缺失和对比度不合格属于必须修复的问题;不影响操作的细微圆角差异再依据设计规范处理。

每条问题记录旧版与新版截图、对应令牌、复现条件、责任人和复测结论。工程组件名称及主题迁移关系可对照 Android 官方 Material 2 至 Material 3 迁移指南。只有主题、布局和交互状态都通过复测,才将该页面标记为迁移完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

审查旧版组件的迁移问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通