UI 视觉设计 / 系统课时
将列表详情改为双栏界面
将列表详情改为双栏界面
手机任务应用通常从任务列表跳转到任务详情。窗口变宽后继续逐页跳转,会让大部分横向空间闲置。本篇以任务管理页为例,将列表与详情改成可切换的单栏、双栏布局,并明确选中状态、返回操作和折叠设备上的连续体验。
学习目标
- 按应用窗口宽度决定显示单栏还是双栏。
- 设计列表选中项与详情内容的同步规则。
- 验收窗口缩放、系统返回和折叠状态切换。
按窗口宽度决定展示方式
判断依据是应用当前可用窗口,而不是设备是否叫平板;分屏、自由窗口和折叠都可能实时改变宽度。按 Android 的宽度尺寸级别,先采用以下设计基线:
| 窗口宽度 | 设计基线 | 点选列表项后的结果 |
|---|---|---|
| 小于600dp(Compact) | 单栏 | 列表切换为全屏详情 |
| 600~839dp(Medium) | 默认单栏 | 列表切换为全屏详情 |
| 840dp及以上(Expanded及更大) | 双栏 | 列表不消失,右侧更新详情 |
这是本案例的基线,不表示达到840dp就必须挤入双栏。若窗口高度小于480dp、侧边导航占用过多宽度或放大字体后内容拥挤,应检查实际剩余空间,必要时退回单栏。
把手机的两页重新分配为两个窗格
沿用同一份任务数据,不复制两套页面内容。窄窗口保留原先的列表页与详情页切换;宽窗口则让左侧负责浏览、筛选和高亮,右侧负责显示任务字段、备注及操作。
例如,扣除窗口安全边距和全局导航后,内容区域可用宽度为1024dp,可采用以下项目参数:
| 区域 | 宽度 | 用途 |
|---|---|---|
| 列表窗格 | 320dp | 任务名称、状态、截止日期 |
| 栏间间距 | 24dp | 分隔两种信息层级 |
| 详情窗格 | 680dp | 标题、描述、负责人、检查项 |
两栏分别允许纵向滚动,避免详情滚动带走左侧列表的定位。宽度变化时详情优先获得伸缩空间;若无法维持可读的内容宽度,则切回单栏。

让选中项与详情始终指向同一任务
交付给开发的选择状态可以命名为 selectedTaskId,其值是稳定任务ID,而非列表行号。行号会随排序与筛选变化,不能用作详情关联依据。
以列表中的 T-104“整理发布清单”和 T-105“验证支付流程”为例,约定以下可验证行为:
- 初次进入宽屏且没有已选任务时,左侧展示完整列表,右侧显示“选择一项任务查看详情”,不擅自选中首项。
- 点击 T-104,左侧该行出现选中背景与指示条,右侧标题及字段同时切换至 T-104;再次点击 T-105,两处同步更新。
- 列表筛选暂时隐藏 T-105 时,如果该任务仍存在,详情继续显示 T-105,并用筛选提示解释为什么列表里看不到高亮行。
- 删除当前任务后清空
selectedTaskId,右侧恢复空态;数据加载失败时显示错误和重试操作,不要把失败误画成“未选择”。
窄屏中点击任务后展示全屏详情,不再额外叠加底部弹层。两种布局始终使用相同的任务ID、编辑结果和加载状态。
规定系统返回和窗口变化后的去向
列表项被点选与应用进入新导航层级不是同一件事。双栏下从 T-104 切到 T-105,只更新右侧内容,不要让系统返回逐条倒放浏览过的任务。
| 用户操作 | 应显示的结果 |
|---|---|
| 单栏:列表点选T-104 | 进入T-104全屏详情 |
| 单栏:详情按系统返回 | 返回任务列表;按本案例规则清除当前选择 |
| 双栏:从T-104点选T-105 | 左侧高亮T-105,右侧立即显示T-105 |
| 双栏:按系统返回 | 返回应用上一导航层级,不逐个回退详情任务 |
| 双栏收窄为单栏 | 已选任务存在则继续显示其详情;否则显示列表 |
| 单栏展开为双栏 | 列表重新出现,右侧保留当前详情和选中高亮 |
从外部深链直接打开详情时,系统返回应遵循真实来源或应用导航约定,不能假设用户一定从列表进入。编辑过程中若有未保存修改,切换任务、返回和收窄窗口都要按同一套保存或放弃规则处理。
在 Jetpack Compose 项目中,NavigableListDetailPaneScaffold 可作为实现参考;默认的 PopUntilScaffoldValueChange 返回策略与上面“单栏退回列表、双栏不逐项倒退”的方向一致,但仍需核对应用自身导航层级。
处理折痕并完成验收
折叠设备展开后的宽屏不等于一整块没有障碍的画布。若设备铰链或不可显示折痕穿过内容,优先让列表和详情分居两侧,不让正文、复选框或底部保存按钮横跨折痕;本案例为邻近折痕的内容边缘预留16dp安全内边距。实际放不下时改为单栏。

验收时至少在360dp、720dp、839dp、840dp和1024dp窗口宽度检查选中高亮、详情滚动、返回按钮和空态,再测试横竖屏切换、分屏拖动、折叠与展开。特别验证:在1024dp选中T-104后收窄至360dp,详情仍为T-104;再次展开,高亮和详情仍一一对应。设计稿应交付单栏列表、单栏详情、双栏已选、双栏未选四种状态及以上交互说明。
Android 官方的列表—详情布局指南可用于核对开发交接时的窗格与返回行为。