日本語版 👈 中文版 👈

UITableViewForUnity is a component which can be used for implementing various list UI views with the Unity engine.

For example

Chat	Nested Scrolling	Appendable List
Snapping	Expandable List	Grid
Changeable Grid	Draggable Grid	Deletable Grid

UITableViewForUnity will help you to develop various list views effectively without worrying about the number of items (GameObjects), because they will be reused when they disappear from the viewport of the ScrollRect. Also, you can turn off the reuse feature for any cell which you do not want to reuse.

• Cell Lifecycle Management: Three types of cell lifecycle options:

  • RecycleWhenDisappeared: Cells are recycled when they scroll out of view (default, best for performance)
  • RecycleWhenReloaded: Cells remain until ReloadData() is called (useful for heavy cells)
  • DestroyWhenDisappeared: Cells are destroyed when they scroll out of view

• Multiple Cell Types: Support different cell types in a single table view (e.g., messages, images, locations in a chat app)

• Dynamic Cell Sizes: Each cell can have a different height/width

• Append/Prepend Data: Add cells to the beginning or end of the list dynamically

• Scroll to Index: Programmatically scroll to any cell by index

1. Open the Unity Package Manager.
2. Select "Add package from git URL".
3. Enter https://github.com/zhaozilong1988/UITableViewForUnity.git?path=Assets/UIKit.

Download the unitypackage from the Releases, then import it to your project.

The project version declaration remains Unity 2019.4.40f1; the package-compatibility repair is validated with Unity 6000.6.0f1. Unity 2019.4 execution is not verified for this change. The library's scripts, scenes, prefabs and package minimum-version declaration are unchanged.

The project no longer depends on the unused Unity Version Control (com.unity.collab-proxy) integration or the obsolete com.unity.modules.vr package. The repository uses Git; install a Version Control package compatible with your Editor separately if you need Unity Version Control. Rider integration is pinned to 3.0.36, which still declares Unity 2019.4 support in the Unity registry. Package changes are resolved through UnityEditor.PackageManager.Client.AddAndRemove; the checked-in lock includes the built-in packages resolved by Unity 6.6, and another Editor version may regenerate those built-in entries.

If Package Manager repeatedly throws FormatException after resolving a Git conflict in Packages/packages-lock.json, first check that both package JSON files are valid and contain no conflict markers. The observed exception came from Unity's Package Manager error-formatting path after a JSON parse failure. Once the file is repaired, close and reopen Package Manager or restart that project's Editor to discard the failed in-memory operation. This is separate from the dependency/compiler errors fixed here; no Unity internals are patched or exceptions suppressed.

Create a class that extends UITableViewCell:

using UnityEngine.UI;

namespace UIKit.Samples
{
    public class SimpleCell : UITableViewCell
    { 
        public Text text; 
        public Image icon; 
        public Image background;
    }
}

Create a MonoBehaviour that implements IUITableViewDataSource and IUITableViewDelegate:

using UnityEngine;

namespace UIKit.Samples
{
    public class SimpleTableScene : MonoBehaviour, IUITableViewDataSource, IUITableViewDelegate
    {
        [SerializeField] UITableView _tableView;
        [SerializeField] SimpleCell _cellPrefab;

        void Start()
        {
            // Set the data source and delegate
            _tableView.dataSource = this;
            _tableView.@delegate = this;

            // Reload the table view to refresh the UI
            _tableView.ReloadData();
        }

        #region IUITableViewDataSource
        // Return the cell for the given index
        public UITableViewCell CellAtIndexInTableView(UITableView tableView, int index)
        {
            return _tableView.ReuseOrCreateCell(_cellPrefab);
        }

        // Return the total number of cells
        public int NumberOfCellsInTableView(UITableView tableView)
        {
            return 200;
        }

        // Return the height (or width for horizontal) of each cell
        public float LengthForCellInTableView(UITableView tableView, int index)
        {
            return index % 2 == 0 ? 150 : 200; // Variable heights
        }
        #endregion

        #region IUITableViewDelegate
        // Called when a cell is about to appear
        public void CellAtIndexInTableViewWillAppear(UITableView tableView, int index)
        {
            var cell = tableView.GetLoadedCell<SimpleCell>(index);
            cell.text.text = $"Cell Index: {index}";
        }

        // Called when a cell has disappeared
        public void CellAtIndexInTableViewDidDisappear(UITableView tableView, int index)
        {
            var cell = tableView.GetLoadedCell<SimpleCell>(index);
            cell.text.text = string.Empty;
        }
        #endregion
    }
}

1. Create a Canvas with a ScrollRect
2. Add a UITableView component to the ScrollRect
3. Create a cell prefab with your SimpleCell script
4. Assign the prefab and UITableView to your scene script

Check the samples in the Assets/UIKit/Samples folder or in the Unity Package Manager's Samples tab:

The design of UITableViewForUnity is based on the UITableView of the UIKit framework on iOS.