循环列表的实现:固定高度、变长项、网格布局与跳转定位
ScrollRect 的基本结构和属性见 UGUI 常用控件。
一、为什么需要循环列表
排行榜、背包、邮件、聊天记录,数据可能有几百上千条。如果每条数据都创建一个 UI 节点:
- 创建慢:一次实例化上千个节点,打开界面时明显卡顿;
- 内存大:每个节点都有 GameObject、组件、网格;
- 滚动慢:Canvas 下元素越多,重建和合批的开销越大(见 UGUI 性能优化)。
但屏幕上同一时间只能看到十几条。循环列表(也叫虚拟列表)的思路是:只创建可见范围内的节点,滚动时把移出视野的节点回收,再拿来显示新进入视野的数据。节点数量是固定的,和数据量无关。
二、核心原理
Content│ items 0 ~ 7: no nodes│ ┌──────────────────────┐ <- Viewport top│ │ item 8 <- node A ││ │ item 9 <- node B ││ │ ... ││ │ item 17 <- node J ││ └──────────────────────┘ <- Viewport bottom│ items 18 ~ 999: no nodes- Content 的高度等于所有数据的总高度,用来撑开滚动范围。
- 只有 Viewport 范围内的第 8 到 17 项有节点(A 到 J),其余的项都没有节点。
每当滚动位置变化:
- 计算可见范围:根据 Content 的滚动偏移和 Viewport 的高度,算出当前应该显示第几项到第几项(前后各多留一两项作为缓冲,避免快速滚动时出现空白)。
- 回收:不在新范围内的节点,放回对象池。
- 补充:新范围内还没有节点的项,从对象池取一个节点,设置位置,绑定数据。
关键点:
- Content 的大小由数据量计算出来,而不是由子节点撑开。ScrollRect 正常滚动,用户感觉不到列表是”假的”。
- 节点的位置由代码计算,不能使用 LayoutGroup 和 ContentSizeFitter。
- 列表本身不关心每一项显示什么,通过回调交给业务代码绑定数据。
三、固定高度的纵向列表
假设:Content 的锚点和轴心都在顶部,宽度拉伸;每一项的锚点和轴心也在顶部。
public class LoopListView : MonoBehaviour{ [SerializeField] ScrollRect scrollRect; [SerializeField] RectTransform itemPrefab; [SerializeField] float itemHeight = 100f; [SerializeField] float spacing = 10f; [SerializeField] int buffer = 1; // 可见范围前后多留的项数
public Action<int, RectTransform> OnBindItem; // 业务代码:把第 index 项数据绑定到节点上
readonly Dictionary<int, RectTransform> _active = new(); // 数据索引 → 正在显示的节点 readonly Stack<RectTransform> _pool = new(); readonly List<int> _toRecycle = new(); int _count;
RectTransform Content => scrollRect.content; float Step => itemHeight + spacing;
void Awake() => scrollRect.onValueChanged.AddListener(_ => Refresh(false));
public void SetCount(int count, bool keepPosition = false) { _count = count; float height = Mathf.Max(0, count * Step - spacing); Content.sizeDelta = new Vector2(Content.sizeDelta.x, height); if (!keepPosition) Content.anchoredPosition = Vector2.zero; Refresh(true); }
void Refresh(bool rebindAll) { float top = Mathf.Max(0, Content.anchoredPosition.y); // 已经向上滚动的距离 float viewHeight = scrollRect.viewport.rect.height; int first = Mathf.Max(0, Mathf.FloorToInt(top / Step) - buffer); int last = Mathf.Min(_count - 1, Mathf.FloorToInt((top + viewHeight) / Step) + buffer);
// 1. 回收不在范围内的节点 _toRecycle.Clear(); foreach (var kv in _active) if (kv.Key < first || kv.Key > last) _toRecycle.Add(kv.Key); foreach (int index in _toRecycle) { var item = _active[index]; _active.Remove(index); item.gameObject.SetActive(false); _pool.Push(item); }
// 2. 补充范围内缺少的节点 for (int i = first; i <= last; i++) { bool isNew = !_active.TryGetValue(i, out var item); if (isNew) { item = _pool.Count > 0 ? _pool.Pop() : Instantiate(itemPrefab, Content); item.gameObject.SetActive(true); item.anchoredPosition = new Vector2(0, -i * Step); _active[i] = item; } if (isNew || rebindAll) OnBindItem?.Invoke(i, item); } }
// 只刷新某一项的显示(数据变化时) public void RefreshItem(int index) { if (_active.TryGetValue(index, out var item)) OnBindItem?.Invoke(index, item); }}使用:
listView.OnBindItem = (index, item) => item.GetComponent<RankItem>().SetData(rankList[index]);listView.SetCount(rankList.Count);要点:
- 回收时不能在遍历字典的同时删除,先收集到列表中再删。
rebindAll用于数据整体变化(比如重新排序)时,让所有可见项重新绑定。- 示例中用
SetActive隐藏回收的节点,简单直观。节点结构复杂、回收频繁时,可以改为把节点移到视野外而不禁用,避免反复触发OnEnable/OnDisable和 Canvas 重建。
四、变长项
聊天消息、邮件这类每项高度不同的列表,不能再用 index × 固定高度 计算位置。
前缀和 + 二分查找
维护一个数组,记录每一项的顶部位置(前缀和):
高度: [ 80, 120, 80, 200, ... ]顶部位置: [ 0, 80, 200, 280, 480, ... ] offsets[i] = 前 i 项的高度之和- 第 i 项的位置:
offsets[i],O(1)。 - Content 的总高度:
offsets[count]。 - 滚动到某个位置时,第一个可见项:在 offsets 中二分查找第一个底部大于滚动距离的项,O(log n)。
int FindFirstVisible(float top){ int lo = 0, hi = _count - 1; while (lo < hi) { int mid = (lo + hi) / 2; if (_offsets[mid + 1] <= top) lo = mid + 1; // 第 mid 项的底部还在 top 之上,说明它不可见 else hi = mid; } return lo;}高度从哪里来
| 方式 | 做法 | 特点 |
|---|---|---|
| 由数据计算 | 根据文字长度、图片数量等预先算出高度 | 最准确,需要业务提供计算方法 |
| 先估算、显示后修正 | 未显示过的项用估算的高度,节点显示并排版后,读取真实高度,更新这一项及之后的前缀和 | 通用,但修正时 Content 的高度会变化,要注意保持当前的滚动位置不跳动 |
| 测量 | 用一个隐藏的测量节点填入数据,LayoutRebuilder.ForceRebuildLayoutImmediate 后读取高度,再缓存起来 | 准确,但测量本身有开销,只在数据变化时做一次 |
高度要缓存起来,只有数据变化时才重新计算。
五、网格布局
背包这类每行多列的列表,按行来计算:
每行列数 columns = 3第 index 项:行 = index / columns,列 = index % columns位置:x = 列 × (宽 + 间距),y = -行 × (高 + 间距)总行数 = Ceil(count / columns),Content 高度按行数计算可见范围:先算出可见的行范围,再换算成数据索引范围 [首行 × columns, (末行 + 1) × columns - 1]列数也可以根据 Viewport 的宽度动态计算,适配不同的屏幕宽度。
六、常用功能
跳转到指定项:
public void ScrollTo(int index){ scrollRect.StopMovement(); float maxScroll = Mathf.Max(0, Content.rect.height - scrollRect.viewport.rect.height); float target = Mathf.Clamp(index * Step, 0, maxScroll); // 变长列表中用 offsets[index] Content.anchoredPosition = new Vector2(Content.anchoredPosition.x, target); Refresh(false);}需要平滑滚动时,用 Tween 对 anchoredPosition 做插值,过程中 onValueChanged 会持续触发刷新。
插入和删除:数据增删后,所有后续项的索引都变了。最简单可靠的做法是调用 SetCount(newCount, keepPosition: true) 并重新绑定所有可见项。
保持位置:聊天列表中,新消息加在底部时,如果玩家正在查看历史消息,不应该把他拉回底部;如果玩家本来就在底部,则自动滚动到最新的一条。
拉到底部加载更多:onValueChanged 中检查是否接近底部(verticalNormalizedPosition 接近 0),触发分页请求。
七、常见的坑
- 不要在 Content 上使用 LayoutGroup 和 ContentSizeFitter,它们会和代码计算的位置冲突。
- 异步加载的图标显示错乱:节点被复用后,旧数据的图标才加载完成,覆盖了新数据的图标。绑定数据时记录版本号,回调时检查(见 过期回调)。
- 节点上残留的状态:复用的节点可能还带着上一条数据的选中状态、动画、计时器。
OnBindItem中要完整地重置所有状态,而不是只设置有值的部分。 - 快速滚动出现空白:增大 buffer,多预留几项。
- 滚动时 Canvas 重建:列表滚动会让所在的 Canvas 频繁重新合批,把列表放在单独的 Canvas 中;Viewport 用 RectMask2D 而不是 Mask。
- 可以参考开源的 LoopScrollRect 等实现,或者成熟的商业插件,不必完全从零开始。
常见追问
滑动列表怎么做?为什么要用循环列表? 只创建可见数量的节点,滚动时根据位置计算可见范围,把移出视野的节点回收到对象池,再复用到新进入视野的项上。节点数量固定,避免大量实例化、内存占用和 Canvas 重建。
循环列表的 Content 高度怎么确定? 由数据量和每项高度计算出来,而不是由子节点撑开,这样 ScrollRect 才能正常滚动。
怎么计算当前显示哪几项? 固定高度时,用滚动距离除以每项的高度;变长时,用前缀和数组加二分查找。
变长项的高度怎么获取? 由数据计算、先估算后修正、或者用隐藏节点测量后缓存。
为什么不能用 LayoutGroup? 节点的位置由代码根据数据索引计算,LayoutGroup 会重新排列子节点,产生冲突,而且布局计算本身开销也大。
复用节点要注意什么? 完整重置节点的状态;异步加载的内容要检查是否过期;快速滚动时增大缓冲。
怎么跳转到指定的某一项? 根据该项的位置(固定高度时为索引乘以步长,变长时为前缀和)设置 Content 的位置,并限制在可滚动范围内,然后刷新。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!