List View

OverviewCopy Anchor Link

List View presents tabular data with text, icons, and custom cell content.

UsageCopy Anchor Link

CustomizationCopy Anchor Link

Scroll ViewCopy Anchor Link

Scale Mode sets where the rows get their height. The header keeps its Header Height in both modes.

Automatic shares the List View’s height between the rows, so they grow and shrink with it, and nothing scrolls. The List View never changes its own size, so anchors, layout groups, and code can size it freely.

Fixed keeps Row Height and scrolls the rows under a pinned header when they don’t fit.

Virtualize Rows, under Fixed, keeps cells only for the rows in view, plus one row above and one below. Rows that scroll out pass their cells to rows that scroll in, so long lists stay light. It’s off by default. In Edit Mode, the scene saves only the rows in view.

With Virtualize Rows on, custom GameObject cells reuse their instances across rows. Set per-row state on them from onRowShown.

In Fixed mode, columns that are wider than the List View scroll sideways, and the header follows the rows. A flexible column then uses its width as a Min Width: it still fills spare space, but never gets narrower.

Scrolling uses the Evo UI Scroll Rect, so Smooth Scroll, Inertia, and Movement Type behave the same way. An axis only scrolls while its rows or columns don’t fit, so a List View with nothing to scroll leaves the mouse wheel to a parent scroll view. With Auto Hide Scrollbars, each assigned scrollbar shows only while its axis can scroll.

Selecting a control inside a cell, for example with a gamepad, scrolls that cell into view.

SpacingCopy Anchor Link

Column, row, and content spacing accept negative values to overlap neighbors. With Show Border on, a spacing of minus the Outline Width merges neighboring outlines into single lines.

TipsCopy Anchor Link

• Each column can use a fixed or flexible width.
• ListViewCellData describes the cell type, label, icon, custom object, and background visibility.
• Use SetCellData() when changing more than text.

NotesCopy Anchor Link

ImportFromCSV() and ExportToCSV() handle text-based table data. CSV does not preserve Unity object references such as sprites or custom prefabs.

Public APICopy Anchor Link

Use ListView in the Evo.UI namespace.

Use RefreshCell() for a targeted update or Rebuild() after structural changes. Cell clicks are reported by onCellClicked.

With Virtualize Rows on, rows out of view have no cell objects. GetCellObject() and GetCellCustomInstance() return null for them, and SetCellValue() or RefreshCell() on them only updates the data, which shows when the row scrolls into view.

PropertiesCopy Anchor Link

FieldsCopy Anchor Link

MethodsCopy Anchor Link

EventsCopy Anchor Link

ExampleCopy Anchor Link

using UnityEngine;
using Evo.UI;

public class ListViewExample : MonoBehaviour
{
    [SerializeField] private ListView target;

    private void Start()
    {
        target.ClearRows();
        // Configure two columns in the Inspector before adding these rows.
        target.AddRow("Player", "1200");
        target.AddRow("Guest", "950");
        target.onCellClicked.AddListener((row, column) =>
            Debug.Log(target.GetCellValue(row, column)));
    }
}