# UIWrapContent

[![NPM](https://img.shields.io/npm/v/io.eframework.unity.uiplugin?label=NPM&logo=npm)](https://www.npmjs.com/package/io.eframework.unity.uiplugin)
[![UPM](https://img.shields.io/npm/v/io.eframework.unity.uiplugin?label=UPM&logo=unity&registry_uri=https://package.openupm.com)](https://openupm.com/packages/io.eframework.unity.uiplugin)
[![DeepWiki](https://img.shields.io/badge/DeepWiki-Explore-blue)](https://deepwiki.com/eframework-io/Unity.UIPlugin)
[![Discord](https://img.shields.io/discord/1422114598835851286?label=Discord&logo=discord)](https://discord.gg/XMPx2wXSz3)

UIWrapContent 拓展至 ScrollRect 视图组件，提供了高效的大数据列表和网格显示能力，通过元素复用降低内存占用。

## 功能特性

- 多种布局模式：支持垂直列表、水平列表、垂直网格、水平网格四种布局
- 元素复用机制：支持元素复用，只创建可见区域所需的 UI 单元格元素
- 适配器支持：提供灵活的适配器接口，便于自定义数据绑定逻辑

## 使用手册

### 1. 适配器实现

1. 简单适配器：
   ```csharp
   // 创建简单适配器
   wrapContent.Adapter = new UIWrapContent.ISimpleAdapter(
       wrapContent,
       () => dataList.Count, // 获取数据总数
       (cell, index) => {
           // 设置单元格数据
           cell.GetComponent<Text>().text = dataList[index].ToString();
       }
   );
   ```

2. 自定义适配器：
   ```csharp
   // 创建自定义适配器类
   public class MyAdapter : UIWrapContent.ICustomAdapter 
   {
       private List<ItemData> dataList;
       
       public MyAdapter(List<ItemData> dataList) {
           this.dataList = dataList;
       }
       
       public bool SingleZygote => false; // 多种单元格类型
       
       public int GetCellType(int index) {
           return dataList[index].type; // 根据数据类型返回
       }
       
       public RectTransform GetCellZygote(int type) => Object.FindAnyObjectByType<UIWrapContent>().content.GetChild(0).GetComponent<RectTransform>();
       
       public int GetCellCount() {
           return dataList.Count;
       }
       
       public void SetCellData(RectTransform cell, int index) {
           var data = dataList[index];
           // 根据数据更新UI元素
           if (GetCellType(index) == 0) {
               // 设置类型A单元格的数据
               var nameText = cell.Find("Name").GetComponent<Text>();
               nameText.text = data.name;
           } else {
               // 设置类型B单元格的数据
               var valueText = cell.Find("Value").GetComponent<Text>();
               valueText.text = data.value.ToString();
           }
       }
   }
   
   // 使用自定义适配器
   wrapContent.Adapter = new MyAdapter(dataList);
   ```

### 2. 运行时控制

1. 滚动控制：
   ```csharp
   // 滚动到指定位置（0-1范围）
   wrapContent.ScrollTo(0.5f); // 滚动到中间位置
   wrapContent.ScrollTo(0f);   // 滚动到开头
   wrapContent.ScrollTo(1f);   // 滚动到末尾
   ```

2. 数据更新：
   ```csharp
   // 重新加载列表
   wrapContent.Reload();
   ```

3. 遍历可见项：
   ```csharp
   // 遍历当前可见的所有单元格
   wrapContent.EachItem((index, item) => {
       Debug.Log($"可见项: 索引={index}, 名称={item.name}");
   });
   ```

## 常见问题

### 1. UIWrapContent 组件与 ScrollRect 组件有什么区别？

ScrollRect 会为每个数据项创建一个 UI 单元格元素，当数据量大时会导致性能问题和内存占用过高。  
UIWrapContent 采用元素复用机制，只创建可见区域所需的 UI 单元格元素，特别适合大数据列表。

### 2. 如何优化 UIWrapContent 组件的性能？

以下是一些优化建议：

1. 减少单元格预制体的复杂度，尽量使用简单的UI结构
2. 适当设置缓冲区大小，避免频繁创建和销毁单元格
3. 在SetCellData方法中避免执行昂贵的操作

更多问题，请查阅[问题反馈](../CONTRIBUTING.md#问题反馈)。

## 项目信息

- [更新记录](../CHANGELOG.md)
- [贡献指南](../CONTRIBUTING.md)
- [许可协议](../LICENSE.md)