Туториал: VirtualizedList

Разбор Sample-проекта VirtualizedList — виртуализация, FilteredList, фильтры и компараторы.

---

Что строим

Список из 100+ элементов с виртуализацией (только видимые элементы рендерятся), фильтрацией (чётные/нечётные, выполненные/невыполненные) и сортировкой.

Файлы: Samples~/VirtualizedList/

---

ViewModel

ItemViewModel — элемент списка

[ViewModel]
public partial class ItemViewModel
{
    [Access(Get = Access.Public)]
    [OneWayBind] private int _number;

    [Access(Get = Access.Public)]
    [OneWayBind] private bool _isCompleted;

    public ItemViewModel(int number, bool isCompleted)
    {
        _number = number;
        _isCompleted = isCompleted;
    }
}

[Access(Get = Access.Public)] — свойства Number и IsCompleted доступны для чтения из фильтров и компараторов.

ListViewModel — управление списком

[ViewModel]
[Serializable]
public sealed partial class ListViewModel : IComponentInitializable
{
    [SerializeField] [Min(0)] private int _count = 100;

    [OneTimeBind] private readonly FilteredList<ItemViewModel> _isOnTrueItems;
    [OneTimeBind] private readonly ObservableList<ItemViewModel> _items = new();

    public ListViewModel()
    {
        _isOnTrueItems = new FilteredList<ItemViewModel>(Items, vm => vm.IsCompleted);
    }

    void IComponentInitializable.Initialize()
    {
        for (var i = 0; i < _count; i++)
            Items.Add(CreateElement());
    }

    [RelayCommand]
    private void AddViewModel() => Items.Add(CreateElement());

    [RelayCommand]
    private void InsertViewModel(int index) => Items.Insert(index, CreateElement());

    [RelayCommand]
    private void Move(int oldIndex, int newIndex) => Items.Move(oldIndex, newIndex);

    [RelayCommand]
    private void Swap(int index1, int index2) => Items.Swap(index1, index2);

    [RelayCommand]
    private void Remove(int index) => Items.RemoveAt(index);

    [RelayCommand]
    private void Replace(int index) => Items[index] = CreateElement();

    private ItemViewModel CreateElement()
    {
        var isCompleted = Random.Range(0, 2) is 0;
        return new ItemViewModel(_number++, isCompleted);
    }
}

Ключевые паттерны:

1. IComponentInitializable — интерфейс для инициализации из Unity (вызывается ViewModelInitializeComponent)
2. [Serializable] + [SerializeField] — настройка из Inspector (например, _count)
3. FilteredList<T> — подмножество _items, автоматически фильтрующее по vm.IsCompleted
4. Операции списка — Add, Insert, Move, Swap, RemoveAt, замена по индексу

---

FilteredList

_isOnTrueItems = new FilteredList<ItemViewModel>(Items, vm => vm.IsCompleted);

FilteredList<T> автоматически отслеживает изменения в исходном списке и обновляет отфильтрованный список. Биндер получает только элементы, прошедшие фильтр.

---

Views

ItemView

[View]
public sealed partial class ItemView : MonoView
{
    [RequireBinder(typeof(string))]
    [SerializeField] private MonoBinder[] _number;

    [RequireBinder(typeof(bool))]
    [SerializeField] private MonoBinder[] _isCompleted;
}

Поле _number привязывается к свойству Number по имени; TextMonoBinder принимает int напрямую через INumberBinder.

ListView

[View]
public sealed partial class ListView : MonoView
{
    [RequireBinder(typeof(IReadOnlyList<IViewModel>))]
    [SerializeField] private MonoBinder[] _items;

    [RequireBinder(typeof(IReadOnlyList<IViewModel>))]
    [SerializeField] private MonoBinder[] _isOnTrueItems;
}

Два коллекционных биндера: _items для полного списка, _isOnTrueItems для отфильтрованного.

---

Фильтры и компараторы

ICollectionFilter<IViewModel>

Фильтр для коллекционных биндеров, задаётся в Inspector:

[Serializable]
public sealed class CompletedCollectionFilter : ICollectionFilter<IViewModel>
{
    [SerializeField] private bool _isCompleted;

    public bool Matches(IViewModel item) =>
        item is ItemViewModel viewModel && viewModel.IsCompleted == _isCompleted;
}

[Serializable]
public sealed class EvenCollectionFilter : ICollectionFilter<IViewModel>
{
    [SerializeField] private bool _isInvert;

    public bool Matches(IViewModel item) =>
        item is ItemViewModel viewModel && (viewModel.Number % 2 is 0) != _isInvert;
}

ICollectionOrder<IViewModel>

Сортировка для коллекционных биндеров. Интерфейс наследует IComparer<T>:

[Serializable]
public sealed class NumberCollectionOrder : ICollectionOrder<IViewModel>
{
    [SerializeField] private bool _isInvert;

    public int Compare(IViewModel x, IViewModel y)
    {
        if (x is not ItemViewModel itemX || y is not ItemViewModel itemY) return 0;

        var result = itemX.Number.CompareTo(itemY.Number);
        return _isInvert ? -result : result;
    }
}

Фильтры и сортировки задаются в Inspector на VirtualizedListItemSourceMonoBinder через [SerializeReference].

---

Виртуализация

VirtualizedListItemSourceBinder рендерит только видимые элементы. При прокрутке:

1. Элементы за пределами видимости — деинициализируются и возвращаются в пул
2. Новые видимые элементы — берутся из пула и инициализируются ViewModel

Это позволяет отображать тысячи элементов без проседания производительности.

Настройка в Inspector

1. Добавьте VirtualizedListItemSourceMonoBinder на ListView
2. Укажите префаб элемента в компоненте VirtualizedList
3. Опционально задайте фильтр и/или порядок сортировки на биндере

---

Ключевые паттерны

Паттерн	Описание
FilteredList<T>	Автоматическая фильтрация коллекции
IComponentInitializable	Инициализация ViewModel из Unity-компонента
[Serializable] ViewModel	Настройка ViewModel из Inspector
ICollectionFilter<IViewModel>	Фильтр на стороне View (Inspector)
ICollectionOrder<IViewModel>	Сортировка на стороне View (Inspector)
Виртуализация	Рендеринг только видимых элементов

---

См. также

• Коллекции — FilteredList, ObservableList
• Collection Binders — VirtualizedListItemSourceBinder
• View Factories — PrefabViewPool
• Туториал TodoList — CreateSync, программные биндеры