循环列表的实现:固定高度、变长项、网格布局与跳转定位

2278 字
11 分钟
循环列表的实现:固定高度、变长项、网格布局与跳转定位

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),其余的项都没有节点。

每当滚动位置变化:

  1. 计算可见范围:根据 Content 的滚动偏移和 Viewport 的高度,算出当前应该显示第几项到第几项(前后各多留一两项作为缓冲,避免快速滚动时出现空白)。
  2. 回收:不在新范围内的节点,放回对象池。
  3. 补充:新范围内还没有节点的项,从对象池取一个节点,设置位置,绑定数据。

关键点:

  • 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 的位置,并限制在可滚动范围内,然后刷新。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

循环列表的实现:固定高度、变长项、网格布局与跳转定位
https://xslab.cloud/posts/unity/loop-scroll-list/
作者
LuxFire
发布于
2026-10-14
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格
Unity底层/UI UGUI 由哪些部分组成、一个 Image 是怎么画到屏幕上的;Canvas 的三种渲染模式与排序;RectTransform 的锚点、轴心、anchoredPosition 与 sizeDelta;布局系统的计算顺序;事件系统如何找到点击目标、事件如何冒泡;Graphic 与 VertexHelper 的网格生成;Image 类型、图集与 TextMeshPro;屏幕、UI、世界坐标的转换;以及 Button、Toggle、Slider、ScrollRect、InputField、Dropdown 等常用控件。
2
Unity 字体渲染:Text 与 TextMeshPro 的原理、使用与描边等效果
Unity底层/UI 字体是怎么变成屏幕上的文字的;旧版 Text 的动态字体纹理及其问题;TextMeshPro 的 SDF 原理、字体资源与图集、后备字体、中文字体方案;描边、阴影、发光、渐变等效果的实现原理;富文本、图文混排、逐字动画;以及文字相关的性能注意事项。
3
UGUI 性能优化:Canvas 重建、合批与过度绘制
Unity性能优化 UGUI 的性能问题来自哪里:Canvas 的 Rebuild 与 Rebatch、UI 合批规则、过度绘制和射线检测。以及动静分离、图集、Mask 选择、显隐方式、长列表等常用优化手段。
4
Unity 性能优化总览:从定位问题到 C#、引擎与渲染
Unity性能优化 Unity 常见性能优化点的总览。先讲怎么定位瓶颈,再按 C# 代码、Unity 对象与 API、渲染、UI、内存与加载分类整理,复杂主题链接到专题文章。
5
UI 框架设计:以休闲游戏为例
项目设计/架构 参考 GameFramework、QFramework、FairyGUI 等主流方案,设计一套适合休闲游戏的 UGUI 框架:层级管理、窗口生命周期、窗口栈与返回键、弹窗队列、缓存与资源释放、遮罩与动画、界面切换与闪烁、屏幕适配、组件绑定、红点系统,并给出核心代码骨架。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录