UI Misc

Namespace: Vortex.Unity.UI.Misc Сборка: ru.vortex.unity.ui.misc

Назначение

Утилитарные UI-компоненты общего назначения: расширенная кнопка, счётчики, слайдер с анимацией, контейнер данных, вспомогательные MonoBehaviour.

---

Компоненты

AdvancedButton

Расширенная кнопка с режимами клика, визуальными состояниями и корректной работой внутри ScrollRect. Реализует IPointerEnterHandler, IPointerExitHandler, IPointerDownHandler, IPointerUpHandler, IPointerClickHandler.

Визуальные состояния (через UIStateSwitcher): Free, Hover, Pressed.

OnUpInBorders и OnClick идут через канонический IPointerClickHandler Unity: EventSystem сама определяет, что это клик, а не drag, по превышению EventSystem.pixelDragThreshold. Если кнопка лежит в ScrollRect, при скролле родитель получит drag, и OnPointerClick на кнопке не вызовется — клик корректно подавится без таймеров и собственных порогов.

Если нужен собственный порог дистанции — выставляется глобально через EventSystem.current.pixelDragThreshold (Unity-настройка, влияет на всё UGUI).

Events (Action): OnClick, OnPressed, OnReleased, OnHover, OnExit. UnityEvents (массивы): onClick[], onHover[], onExit[]. Внешнее управление: Press(), Release(), AddOnClick(UnityAction), RemoveOnClick(UnityAction).

Особенности:

• OnPointerEnter сохраняет визуал Pressed, если кнопка ещё прижата (сценарий «нажали → увели за пределы → вернули обратно»).
• AddOnClick(UnityAction) идемпотентен: повторная подписка одного и того же UnityAction игнорируется (_wrappedActions-словарь), RemoveOnClick корректно снимет wrapper.
• Внешний Press()/Release() работает в режиме OnClick: при eventData == null смещение считается нулевым, проверка времени остаётся.

DataStorage

Универсальный контейнер данных. Реализует IDataStorage : IDataSource. FIFO-поиск по типу.

storage.SetData(myModel);                    // полная замена всех данных → OnUpdateLink
storage.SetData(new[] { a, b });             // полная замена набором       → OnUpdateLink
storage.AddData(extraData);                  // добавление/замена по типу    → OnUpdateLink не вызывается
var model = storage.GetData<MyModel>();      // поиск по типу
storage.OnUpdateLink += ReBindAll;           // переподцепить все ссылки

OnUpdateLink — link-level: вызывается только при полной замене содержимого (SetData), которая инвалидирует ранее полученные через GetData<T>() ссылки. AddData не инвоцирует событие, поскольку существующие ссылки остаются валидными.

Точки расширения для наследников:

• Data (protected) — прямой доступ к внутреннему списку из подклассов. Использовать осторожно: запись мимо SetData/AddData не инвоцирует OnUpdateLink.
• dataSwitcher (protected) — управление визуальным состоянием из подкласса.
• OnEnable() / OnDisable() (virtual) — переопределяются в наследниках для подключения дополнительной логики (например, реактивного слоя). Используется, в частности, DataStorageTransport (AssetCacheSystem), который грузит префаб по addressable-ссылке в OnEnable и освобождает в OnDisable.

DataCapturer

Late-binding мост: MonoBehaviour-источник + имя реактивного свойства → IDataStorage. Реализует IDataStorage : IDataSource. Конфигурируется в инспекторе; в редакторе выпадающий список свойств собирается через рефлексию по типу IReactiveData (включая IntData/BoolData/FloatData/любых наследников ReactiveValue<T>).

// На префабе:
//   source   = ссылка на любой MonoBehaviour-источник
//   property = имя свойства (выбирается через ValueSelector с фильтром IReactiveData)

// Потребитель (Pool-итем, generic-handler и т.п.):
capturer.OnUpdateLink += () =>
{
    var data = capturer.GetData<IntData>();  // ссылка на ReactiveValue
    data.OnUpdate += v => UpdateView(v);     // подписка на value-level
};

Жизненный цикл:

• Awake — кеширует PropertyInfo. При отсутствии свойства логирует ошибку, выключает компонент (enabled = false) и не подписывается на источник.
• Если источник реализует IDataSource, подписывается на его OnUpdateLink для отслеживания пересоздания реактивных полей.
• Start — первый RefreshLink() после всех Awake сцены, потребители успевают подписаться.
• RefreshLink сравнивает новую и старую ссылки через ReferenceEquals и инвоцирует OnUpdateLink только при реальной смене ссылки.
• OnDestroy — отписка от источника, зануление кеша.

Ниша: связки, которые нельзя зашить через [UIComponentLink] (атрибутная привязка в коде виджета) — например, generic Pool-итемы, виджеты-шаблоны, сборка связки в инспекторе на префабе. Источник всегда MonoBehaviour — для ScriptableObject-настроек/пресетов используется прямая [SerializeField]-ссылка, не DataCapturer.

CounterViewBase<T> (abstract)

Базовый компонент для отображения счётчика с минимумом/максимумом/текущим значением, слайдером, пульсацией и пороговыми визуальными состояниями.

Наследник реализует:

• int GetValue() — текущее значение
• int GetMinValue() — минимум диапазона
• int GetMaxValue() — максимум диапазона
• void Init() / void DeInit() — подписка/отписка наследника на доменные события

Доступ к модели через protected T Data (кешируется при первом обращении, сбрасывается на UpdateLink).

Поля инспектора (все опциональные — компонент работает с любым подмножеством):

Пороги CounterStates (по проценту заполнения диапазона):

API наследника:

• UpdateValue() / UpdateMinValue() / UpdateMaxValue() — программная переотрисовка соответствующего блока.

CounterViewAdvanced

Готовый наследник CounterViewBase<T> для типового сценария «модель с тремя IntData (current/min/max)». Содержит [SerializeField]-ссылки на свойства источника, маппит их на GetValue/GetMinValue/GetMaxValue и подписывается в Init().

SliderView

Анимированный Slider через AsyncTween.

sliderView.Set(0.75f, 1f);   // value, max

Пропускает обновление если value и max не изменились.

AutoRectSetter

Автонастройка RectTransform через Inspector. [ExecuteAlways] — работает и в Editor, и в Play.

Настраиваемые параметры (каждый включается toggle):

• Borders (left, top, right, bottom, posZ)
• Anchors (anchorMin, anchorMax)
• Pivot
• Rotation (localEulerAngles)

Apply() — применить настройки. ReadFromCurrent() — захватить текущие значения RectTransform.

EnableDelayForChild

Отложенная активация дочерних объектов.

Awake — деактивирует всех детей. OnEnable — планирует активацию через TimeController.Call(). OnDisable — деактивирует.

ScrollRectResetHandler

Сброс ScrollRect в начальную позицию (normalizedPosition = Vector2.one) при Start.

DropDown

Компонент выпадающего списка. Состоит из четырёх классов:

• DropDownComponent — контроллер: toggle open/close, конфигурация через SetList(texts, callback, value). Поддержка сортировки (sorting), UnityEvent<int> onSelected, closeOnSelected, scrollSensitivity. При сортировке строит прямую (_map) и обратную (_mapBack) карту индексов сортированного → оригинального порядка.
• DropDownList — Pool-based список, scroll-позиционирование к выбранному элементу через ScrollRect.normalizedPosition. Кеширует хэш текстов (string.Join) — при повторном вызове Set() с теми же данными обновляет только Current, не пересоздаёт пул.
• DropDownItem — элемент списка. Получает DropDownListModel и IntData (индекс) через IDataStorage. Визуально выделяет текущий элемент через UIComponent.SetSwitcher(SwitcherState.On/Off). Подписывается на OnUpdateData для обновления.
• DropDownListModel — IReactiveData модель: callbacks (select, close), тексты, текущий выбор, closeOnSelected, ScrollSensitivity. Dispose() очищает подписчиков.

API:

dropDown.SetList(texts, OnSelect, currentValue);  // конфигурация
dropDown.SetValue(3);                              // программное переключение
int idx = dropDown.GetValue();                     // оригинальный индекс
string text = dropDown.GetValueItem();             // текст выбранного

Callback Select() всегда возвращает оригинальный (не сортированный) индекс через _mapBack.

Список инстанцируется в Canvas при первом открытии, при закрытии деактивируется, при уничтожении контроллера — уничтожается.

---

Зависимости

---

Граничные случаи