当前位置：首页 > news >正文

Unity UGUI图片循环列表插件

news 2026/2/11 3:22:05

效果展示：

下载链接：https://gf.bilibili.com/item/detail/1111843026

概述：

LoopListView2 是一个与 UGUI ScrollRect 相同的游戏对象的组件。它可以帮助 UGUI ScrollRect 以高效率和节省内存的方式支持任意数量的项目。

对于具有10,000个项目的ScrollRect， LoopListView2并不真正创建10,000个项目，而是根据视窗的大小创建几个项目。

例如，当ScrollRect向上移动时，LoopListView2组件将进行检查最上面的项目的位置，一旦最上面的项目离开视口，则LoopListView2组件将回收最上面的项，同时检查最下方的项目位置，一旦最下方的项目接近视口底部LoopListView2组件将调用onGetItemByIndex处理程序来创建一个新项和然后将新创建的项放置在最下面的项下，因此新创建的项变为新的最下面的项目。

每个项目可以使用不同的预制件，可以有不同的高度/宽度。

在该文件夹中有几个示例可以帮助您了解LoopListView2组件与路径：Assets -> SuperScrollView -> Demo ->场景。菜单场景是入口。

下图是toptobutton安排的滚动矩形的样子：

在上图中，scrollrect有10000个项目，但实际上，只有7个项目真正创建。

Inspector设置：

在Inspector中，为了确保LoopListView2组件工作良好，有几个需要设置的参数：

ItemPrefabList：这是要克隆的现有项。

每个项目可以使用不同的预制件，每个预制件可以有不同的默认填充滚动块中每个项目之间的间距)。而且，每个预制件都可以有不同的默认x本地位置（用于垂直scrollrect）或默认y本地位置（用于水平scrollrect），这里，称为（X/Y） pooffset。每个预制件都有一个回收InitCreateCount是开始时在池中创建的计数。

事实上，在运行时，每个项目可以有不同的填充和（X/Y） posofset，你可以改变一个item的padding和（X/Y）PosOffset在你的onGetItemByIndex回调中。你可以得到/设置它们LoopListViewItem2。填充和LoopListViewItem2。StartPosOffset。

重要提示：所有itemPrefab的localScale必须为（1,1,1）。

SupportScrollbar：如果选中，LoopListView2组件将支持滚动条。

ItemSnapEnable:

如果选中，LoopListView2组件将尝试将项捕捉到中的配置位置ViewPort。

ItemSnapPivot是项目的快速枢轴点的位置，定义为矩形本身大小的一小部分。0,0对应左下角而1,1对应右上角。

ViewPortSnapPivot是ScrollRect ViewPort的snap枢轴点的位置，定义为矩形本身大小的分数。0,0对应左下角，而1,1对应右上角。

ArrangeType：滚动方向，有四种类型：

(1) TopToBottom：这种类型用于垂直滚动，item0,item1，…itemN是在scrollrect视口中从上到下依次定位，就像下面:

(2) BottomToTop：这种类型用于垂直滚动条，item0,item1，…itemN是在scrollrect视口中从下到上依次定位，就像下面:

(3) LeftToRight：这种类型用于水平滚动，item0,item1，…itemN是在scrollrect视口中从左到右依次定位。

(4) righttolleft：该类型用于水平滚动，item0,item1，…itemN是在scrollrect视口中从右到左依次定位。

重要的公开方法：

public void InitListView(int itemTotalCount,
System. Func<LoopListView2, int, LoopListViewItem2> onGetItemByIndex,
LoopListViewInitParam initParam = nu1l)

InitListView方法用于初始化LoopListView2组件。有3个参数：

itemTotalCount：滚动视图中的项目总数。如果该参数设置为-1，则表示有无限项，不支持滚动条，ItemIndex可以从-MaxInt到+MaxInt。如果设置sssa value >=0，则ItemIndex只能来自0到itemTotalCount -1。

onGetItemByIndex：当一个项目进入scrollrect视图时，这个Action将被调用使用项目索引作为参数，以允许您创建项目并更新其内容。LoopListViewItem2是onGetItemByIndex的返回值,每个创建的项目都有一个自动附加的LoopListViewItem2组件：

LoopListViewItem2组件是一个非常简单的例子：

mItemIndex属性表示列表中项目的索引，如上所述，如果itemTotalCount设置为-1，则mItemIndex可以从-MaxInt到+MaxInt。如果将itemTotalCount设置为>=0，则mItemIndex只能在0到itemTotalCount之间取值1。

mItemId属性表示该项的id。此属性在创建项时设置从池中获取，并且在项目回收回池之前将不再更改。下面的代码是onGetItemByIndex的示例：

LoopListViewItem2 OnGetItemByIndex(LoopListView2 listView, int index)
{
if (index < 0 || index >= DataSourceMgr.Get.TotalItemCount)
{
return null;
}
//get the data to showing 
ItemData itemData = DataSourceMgr.Get.GetItemDataByIndex(index);
if(itemData == null)
{
return null;
}
/*get a new item. Every item can use a different prefab, the parameter of the 
NewListViewItem is 
the prefab’name. 
And all the prefabs should be listed in ItemPrefabList in LoopListView2 Inspector 
Setting */ 
LoopListViewItem2 item = listView.NewListViewItem("ItemPrefab1");
ListItem2 itemScript = item.GetComponent<ListItem2>();
// IsInitHandlerCalled is false means this item is new created but not fetched from pool. 
if (item.IsInitHandlerCalled == false)
{
item.IsInitHandlerCalled = true;
itemScript.Init();// here to init the item, such as add button click event listener.
}
//update the item’s content for showing, such as image,text. 
itemScript.SetItemData(itemData,index);
return item;
}