游戏客户端架构 / 系统课时
列表界面怎么避免互相引用
列表界面怎么避免互相引用
背包、任务和排行榜都包含“数据集合、列表容器、列表项”三个角色。最容易失控的做法,是让列表项直接查页面状态,页面又逐个操作列表项,数据源同时持有 UI 引用。本节把这些依赖改成单向数据流,使列表项可复用、页面可测试,刷新逻辑也更容易定位。
学习目标
- 划分数据源、页面控制器、列表容器和列表项的职责
- 使用数据向下、事件向上的方式避免循环依赖
- 处理选中、刷新和列表项复用时的常见边界问题
先拆清列表里的四个角色
一个稳定的列表界面通常可以分成四层职责。
| 角色 | 负责什么 | 不应该负责什么 |
|---|---|---|
| 数据源 | 保存或提供物品、任务、排行数据 | 操作具体列表项控件 |
| 页面控制器 | 请求数据、维护筛选和选中状态、响应用户事件 | 保存每个列表项内部视觉细节 |
| 列表容器 | 根据数据创建、复用、排列列表项 | 决定任务能否领取等业务规则 |
| 列表项 | 展示单条数据并发出点击等事件 | 反向寻找页面或直接修改全局数据 |
问题往往从“为了方便直接拿一下引用”开始。比如任务列表项点击领取按钮后,直接调用任务页面;任务页面刷新时又遍历所有列表项修改状态。一旦列表项被放到弹窗或其他页面复用,它仍然依赖原来的任务页面,复用边界就被破坏了。
让数据向下流,事件向上走
推荐的数据流是:页面控制器获得数据,把当前需要展示的数据交给列表容器;列表容器把单条数据绑定给列表项;列表项只负责渲染。当用户点击列表项时,它向上发送一个包含必要标识的事件,由页面控制器决定后续业务动作。

这里的关键不是使用哪一种事件机制,而是依赖方向。列表项需要知道“有人点击了我”,但不需要知道点击以后是打开详情、领取奖励还是切换装备。
以排行榜为例,列表项可以输出玩家 ID;页面控制器收到事件后,再决定打开玩家资料。这样同一个排行列表项以后放到赛季榜、公会榜或好友榜时,不需要知道具体页面类型。
页面状态不要塞进列表项
列表项只应该持有渲染当前内容所需的数据。筛选条件、当前分页、正在加载、全局选中对象等页面级状态,应由页面控制器维护。
选中状态尤其容易产生双向依赖。不要让每个列表项自己宣布“我是当前唯一选中项”,再主动取消其他列表项。更稳定的做法是由页面控制器保存 selectedId,列表渲染时根据每条数据的 ID 判断是否显示选中态。
这种方式还有一个额外好处:当列表项被虚拟化或对象池复用时,旧列表项离开屏幕后不会丢失真正的选中状态。新创建或重新绑定的列表项只要读取当前视图数据,就能恢复正确外观。
刷新时重新描述界面,而不是逐控件修补
复杂列表常见的另一个问题,是业务操作结束后到处寻找控件进行局部修改。例如领取任务奖励后,同时修改按钮文字、奖励图标、红点和顶部计数。随着 UI 增长,这种命令式修补会形成大量跨组件引用。
更容易维护的方式是先更新业务状态,再让页面控制器重新计算当前视图需要的数据。列表项收到新数据后重新渲染自己的局部内容。只有明确存在性能瓶颈时,才需要进一步做精确的增量更新。
对于背包界面,可以把流程保持为:玩家执行使用物品操作,业务层更新物品数量,页面控制器得到新的背包状态,根据筛选和排序得到展示列表,再把结果交给列表容器。列表项不需要知道物品数量为什么变化。
检查是否已经产生循环依赖
实现完成后,可以用几个现象快速判断边界是否健康:
- 把一个列表项单独放进测试页面时,不需要创建原页面控制器也能展示数据。
- 页面控制器可以处理点击事件,但不需要知道某个具体列表项实例位于第几个可视槽位。
- 数据源可以在没有 UI 的情况下独立加载和更新数据。
- 列表刷新后,即使列表项实例被全部替换,选中、领取状态和业务结果仍然正确。
如果列表项必须通过父节点查找页面脚本,页面必须保存所有列表项引用,或者数据模型直接调用控件刷新方法,就说明依赖已经开始闭环。优先把业务状态收回页面控制器或业务层,再把列表项缩减为“接收数据、展示内容、发送事件”的角色,背包、任务和排行榜就能共享同一种稳定的列表架构。