AlicizaX/com.alicizax.unity.ui.extension
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: AlicizaX:ff545585d731ced4089dd2684b15c8824ab41bf1
Branches Tags
AlicizaX:main
..
compare: AlicizaX:b6dacac94d83a4e4ebe3adde64d323345d115a4a
Branches Tags
AlicizaX:main

No commits in common. "ff545585d731ced4089dd2684b15c8824ab41bf1" and "b6dacac94d83a4e4ebe3adde64d323345d115a4a" have entirely different histories.
ff545585d7 ... b6dacac94d

6 changed files with 170 additions and 340 deletions
Show Stats Expand all files Collapse all files

4
Runtime/RecyclerView/Adapter/Adapter.cs
View File

@ -37,8 +37,6 @@ namespace AlicizaX.UI
set => SetChoiceIndex(value);
}
internal Action<int> OnChoiceIndexChanged;
public Adapter(RecyclerView recyclerView) : this(recyclerView, new List<T>())
{
}
@ -385,8 +383,6 @@ namespace AlicizaX.UI
{
UpdateSelectionState(newHolder, true);
}
OnChoiceIndexChanged?.Invoke(choiceIndex);
}
protected virtual bool TryGetBindData(int index, out T data)

57
Runtime/RecyclerView/Adapter/GroupAdapter.cs
View File

@ -26,11 +26,6 @@ namespace AlicizaX.UI
return showList.Count;
}
public override int GetRealCount()
{
return showList.Count;
}
public override string GetViewName(int index)
{
return index >= 0 && index < showList.Count
@ -65,10 +60,10 @@ namespace AlicizaX.UI
continue;
}
CollapseInternal(i);
Collapse(i);
if (group.Expanded)
{
ExpandInternal(i);
Expand(i);
i += CountItemsForType(group.Type);
}
}
@ -98,47 +93,6 @@ namespace AlicizaX.UI
}
public void Expand(int index)
{
SetExpanded(index, true);
}
public void Collapse(int index)
{
SetExpanded(index, false);
}
public bool SetExpanded(int index, bool expanded)
{
if (!TryGetDisplayData(index, out TData data) || !IsGroupIndex(index))
{
return false;
}
data.Expanded = expanded;
NotifyDataChanged();
return true;
}
public bool IsGroupIndex(int index)
{
return index >= 0 &&
index < showList.Count &&
string.Equals(showList[index].TemplateName, groupViewName, StringComparison.Ordinal);
}
public bool TryGetDisplayData(int index, out TData data)
{
if (list == null || index < 0 || index >= showList.Count)
{
data = default;
return false;
}
data = showList[index];
return true;
}
private void ExpandInternal(int index)
{
if (list == null || index < 0 || index >= showList.Count)
{
@ -156,7 +110,7 @@ namespace AlicizaX.UI
}
}
private void CollapseInternal(int index)
public void Collapse(int index)
{
if (index < 0 || index >= showList.Count)
{
@ -201,9 +155,10 @@ namespace AlicizaX.UI
}
TData data = showList[index];
if (IsGroupIndex(index))
if (data.TemplateName == groupViewName)
{
SetExpanded(index, !data.Expanded);
data.Expanded = !data.Expanded;
NotifyDataChanged();
return;
}

42
Runtime/RecyclerView/RecyclerView.cs
View File

@ -413,7 +413,7 @@ namespace AlicizaX.UI
/// <summary>
/// 获取当前记录的内部逻辑索引。
/// 仅供框架内部的导航与布局逻辑使用；业务层请改用 <see cref="OnFocusIndexChanged"/> 维护自身状态，
/// 仅供框架内部的导航与布局逻辑使用；业务层请改用 <see cref="OnIndexChanged"/> 维护自身状态，
/// 或使用适配器上的 <c>ChoiceIndex</c> 表示业务选中项。
/// </summary>
internal int CurrentIndex => currentIndex;
@ -425,22 +425,12 @@ namespace AlicizaX.UI
/// <summary>
/// 当当前逻辑索引发生变化时触发。
/// </summary>
public Action<int> OnFocusIndexChanged;
public Action<int> OnIndexChanged;
/// <summary>
/// 当滚动位置发生变化时触发。
/// </summary>
public Action<float> OnScrollValueChanged;
/// <summary>
/// 当滚动停止时触发。
/// </summary>
public Action OnScrollStopped;
/// <summary>
/// 当拖拽状态变化时触发。
/// </summary>
public Action<bool> OnScrollDraggingChanged;
public Action OnScrollValueChanged;
#endregion
@ -542,7 +532,6 @@ namespace AlicizaX.UI
scroller.Snap = snap;
scroller.OnValueChanged.AddListener(OnScrollChanged);
scroller.OnMoveStoped.AddListener(OnMoveStoped);
scroller.OnDragging.AddListener(OnScrollerDraggingChanged);
UpdateScrollerState();
}
@ -979,6 +968,10 @@ namespace AlicizaX.UI
float targetPosition = CalculateScrollPositionWithAlignment(index, alignment, offset);
if (UGListExtensions.DebugScrollTo)
{
Debug.Log($"[RecyclerView] ScrollToWithAlignment: index={index}, alignment={alignment}, offset={offset}, targetPosition={targetPosition}, maxPosition={scroller.MaxPosition}");
}
if (duration > 0 && smooth)
{
@ -1029,6 +1022,11 @@ namespace AlicizaX.UI
// 叠加调用方传入的额外偏移量。
targetPosition += offset;
if (UGListExtensions.DebugScrollTo)
{
Debug.Log($"[RecyclerView] CalculateScrollPosition: index={index}, itemPosition={itemPosition}, itemSize={itemSize}, viewportLength={viewportLength}, contentLength={contentLength}, targetPosition={targetPosition}, maxPosition={scroller.MaxPosition}");
}
// 将结果限制在可滚动范围内。
return Mathf.Clamp(targetPosition, 0, scroller.MaxPosition);
}
@ -1076,7 +1074,7 @@ namespace AlicizaX.UI
UpdateScrollbarValue(position);
UpdateVisibleRange();
layoutManager.DoItemAnimation();
OnScrollValueChanged?.Invoke(position);
OnScrollValueChanged?.Invoke();
}
/// <summary>
@ -1090,16 +1088,6 @@ namespace AlicizaX.UI
}
TryProcessPendingFocusRequest();
OnScrollStopped?.Invoke();
}
/// <summary>
/// 响应滚动器拖拽状态变化。
/// </summary>
/// <param name="dragging">当前是否正在拖拽。</param>
private void OnScrollerDraggingChanged(bool dragging)
{
OnScrollDraggingChanged?.Invoke(dragging);
}
/// <summary>
@ -1422,7 +1410,7 @@ namespace AlicizaX.UI
if (currentIndex != -1)
{
currentIndex = -1;
OnFocusIndexChanged?.Invoke(currentIndex);
OnIndexChanged?.Invoke(currentIndex);
}
return;
@ -1434,7 +1422,7 @@ namespace AlicizaX.UI
if (currentIndex != index)
{
currentIndex = index;
OnFocusIndexChanged?.Invoke(currentIndex);
OnIndexChanged?.Invoke(currentIndex);
}
}

381
Runtime/RecyclerView/UGList.cs
View File

@ -1,19 +1,36 @@
using System;
using System.Collections.Generic;
using UnityEngine.EventSystems;
namespace AlicizaX.UI
{
public abstract class UGListBase<TData, TAdapter>
where TAdapter : Adapter<TData>
where TData : ISimpleViewData
/// <summary>
/// 封装 RecyclerView 与 Adapter 的通用列表基类。
/// </summary>
/// <typeparam name="TData">列表数据类型。</typeparam>
/// <typeparam name="TAdapter">适配器类型。</typeparam>
public abstract class UGListBase<TData, TAdapter> where TAdapter : Adapter<TData> where TData : ISimpleViewData
{
/// <summary>
/// 关联的 RecyclerView 实例。
/// </summary>
protected readonly RecyclerView _recyclerView;
/// <summary>
/// 当前列表使用的适配器实例。
/// </summary>
protected readonly TAdapter _adapter;
private List<TData> _datas;
/// <summary>
/// 获取当前绑定的 RecyclerView。
/// </summary>
public RecyclerView RecyclerView => _recyclerView;
protected UGListBase(RecyclerView recyclerView, TAdapter adapter)
/// <summary>
/// 初始化列表封装并将适配器绑定到 RecyclerView。
/// </summary>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <param name="adapter">用于驱动列表渲染的适配器。</param>
public UGListBase(RecyclerView recyclerView, TAdapter adapter)
{
_recyclerView = recyclerView;
_adapter = adapter;
@ -24,10 +41,60 @@ namespace AlicizaX.UI
}
}
public RecyclerView RecyclerView => _recyclerView;
/// <summary>
/// 获取当前列表使用的适配器。
/// </summary>
public TAdapter Adapter => _adapter;
/// <summary>
/// 注册指定视图类型对应的 ItemRender。
/// </summary>
/// <typeparam name="TItemRender">ItemRender 类型。</typeparam>
/// <param name="viewName">视图名称；为空时表示默认视图。</param>
public void RegisterItemRender<TItemRender>(string viewName = "") where TItemRender : ItemRenderBase
{
_adapter.RegisterItemRender<TItemRender>(viewName);
}
/// <summary>
/// 按运行时类型注册指定视图对应的 ItemRender。
/// </summary>
/// <param name="itemRenderType">ItemRender 的运行时类型。</param>
/// <param name="viewName">视图名称；为空时表示默认视图。</param>
public void RegisterItemRender(Type itemRenderType, string viewName = "")
{
_adapter.RegisterItemRender(itemRenderType, viewName);
}
/// <summary>
/// 注销指定视图名称对应的 ItemRender 注册。
/// </summary>
/// <param name="viewName">视图名称；为空时表示默认视图。</param>
/// <returns>是否成功移除对应注册。</returns>
public bool UnregisterItemRender(string viewName = "")
{
return _adapter.UnregisterItemRender(viewName);
}
/// <summary>
/// 清空当前列表的全部 ItemRender 注册信息。
/// </summary>
public void ClearItemRenderRegistrations()
{
_adapter.ClearItemRenderRegistrations();
}
/// <summary>
/// 当前持有的数据集合引用。
/// </summary>
private List<TData> _datas;
/// <summary>
/// 获取或设置当前列表数据。
/// </summary>
/// <remarks>
/// 设置数据时会同步调用适配器刷新列表内容。
/// </remarks>
public List<TData> Data
{
get => _datas;
@ -37,288 +104,112 @@ namespace AlicizaX.UI
_adapter.SetList(_datas);
}
}
public int DataCount => _datas?.Count ?? 0;
public int FocusIndex => _recyclerView != null ? _recyclerView.CurrentIndex : -1;
public int ChoiceIndex
{
get => _adapter != null ? _adapter.ChoiceIndex : -1;
set
{
if (_adapter != null)
{
_adapter.ChoiceIndex = value;
}
}
}
public bool HasChoice => ChoiceIndex >= 0;
public float ScrollPosition => _recyclerView != null ? _recyclerView.GetScrollPosition() : 0f;
public event Action<int> OnFocusIndexChanged
{
add
{
if (_recyclerView != null)
{
_recyclerView.OnFocusIndexChanged += value;
}
}
remove
{
if (_recyclerView != null)
{
_recyclerView.OnFocusIndexChanged -= value;
}
}
}
public event Action<int> OnChoiceIndexChanged
{
add
{
if (_adapter != null)
{
_adapter.OnChoiceIndexChanged += value;
}
}
remove
{
if (_adapter != null)
{
_adapter.OnChoiceIndexChanged -= value;
}
}
}
public event Action<float> ScrollValueChanged
{
add
{
if (_recyclerView != null)
{
_recyclerView.OnScrollValueChanged += value;
}
}
remove
{
if (_recyclerView != null)
{
_recyclerView.OnScrollValueChanged -= value;
}
}
}
public event Action ScrollStopped
{
add
{
if (_recyclerView != null)
{
_recyclerView.OnScrollStopped += value;
}
}
remove
{
if (_recyclerView != null)
{
_recyclerView.OnScrollStopped -= value;
}
}
}
public event Action<bool> ScrollDraggingChanged
{
add
{
if (_recyclerView != null)
{
_recyclerView.OnScrollDraggingChanged += value;
}
}
remove
{
if (_recyclerView != null)
{
_recyclerView.OnScrollDraggingChanged -= value;
}
}
}
public void RegisterItemRender<TItemRender>(string viewName = "") where TItemRender : ItemRenderBase
{
_adapter.RegisterItemRender<TItemRender>(viewName);
}
public void RegisterItemRender(Type itemRenderType, string viewName = "")
{
_adapter.RegisterItemRender(itemRenderType, viewName);
}
public bool UnregisterItemRender(string viewName = "")
{
return _adapter.UnregisterItemRender(viewName);
}
public void ClearItemRenderRegistrations()
{
_adapter.ClearItemRenderRegistrations();
}
public void ClearChoice()
{
ChoiceIndex = -1;
}
public bool TryFocus(int index, bool smooth = false, ScrollAlignment alignment = ScrollAlignment.Center)
{
return _recyclerView != null && _recyclerView.TryFocusIndex(index, smooth, alignment);
}
public bool TryFocusChoice(bool smooth = false, ScrollAlignment alignment = ScrollAlignment.Center)
{
int index = ChoiceIndex;
return index >= 0 && TryFocus(index, smooth, alignment);
}
public bool TryFocusEntry(MoveDirection entryDirection)
{
return _recyclerView != null && _recyclerView.TryFocusEntry(entryDirection);
}
public void ScrollToIndex(int index, bool smooth = false)
{
_recyclerView?.ScrollTo(index, smooth);
}
public void ScrollTo(
int index,
ScrollAlignment alignment = ScrollAlignment.Start,
float offset = 0f,
bool smooth = false,
float duration = 0.3f)
{
_recyclerView?.ScrollToWithAlignment(index, alignment, offset, smooth, duration);
}
public void ScrollToChoice(
ScrollAlignment alignment = ScrollAlignment.Center,
float offset = 0f,
bool smooth = false,
float duration = 0.3f)
{
int index = ChoiceIndex;
if (index >= 0)
{
ScrollTo(index, alignment, offset, smooth, duration);
}
}
public void ScrollToFocus(
ScrollAlignment alignment = ScrollAlignment.Center,
float offset = 0f,
bool smooth = false,
float duration = 0.3f)
{
int index = FocusIndex;
if (index >= 0)
{
ScrollTo(index, alignment, offset, smooth, duration);
}
}
public void ScrollToStart(int index, float offset = 0f, bool smooth = false, float duration = 0.3f)
{
ScrollTo(index, ScrollAlignment.Start, offset, smooth, duration);
}
public void ScrollToCenter(int index, float offset = 0f, bool smooth = false, float duration = 0.3f)
{
ScrollTo(index, ScrollAlignment.Center, offset, smooth, duration);
}
public void ScrollToEnd(int index, float offset = 0f, bool smooth = false, float duration = 0.3f)
{
ScrollTo(index, ScrollAlignment.End, offset, smooth, duration);
}
}
/// <summary>
/// 提供单模板列表的便捷封装。
/// </summary>
/// <typeparam name="TData">列表数据类型。</typeparam>
public class UGList<TData> : UGListBase<TData, Adapter<TData>> where TData : ISimpleViewData
{
/// <summary>
/// 初始化单模板列表。
/// </summary>
/// <param name="recyclerView">目标 RecyclerView。</param>
public UGList(RecyclerView recyclerView)
: base(recyclerView, new Adapter<TData>(recyclerView))
{
}
}
/// <summary>
/// 提供分组列表的便捷封装。
/// </summary>
/// <typeparam name="TData">分组列表数据类型。</typeparam>
public class UGGroupList<TData> : UGListBase<TData, GroupAdapter<TData>> where TData : class, IGroupViewData, new()
{
/// <summary>
/// 初始化分组列表。
/// </summary>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <param name="groupViewName">分组头使用的模板名称。</param>
public UGGroupList(RecyclerView recyclerView, string groupViewName)
: base(recyclerView, new GroupAdapter<TData>(recyclerView, groupViewName))
{
}
public bool IsGroupIndex(int index)
{
return _adapter.IsGroupIndex(index);
}
public bool TryGetDisplayData(int index, out TData data)
{
return _adapter.TryGetDisplayData(index, out data);
}
public bool SetExpanded(int index, bool expanded)
{
return _adapter.SetExpanded(index, expanded);
}
public void Expand(int index)
{
_adapter.Expand(index);
}
public void Collapse(int index)
{
_adapter.Collapse(index);
}
public void Activate(int index)
{
_adapter.Activate(index);
}
}
/// <summary>
/// 提供循环列表的便捷封装。
/// </summary>
/// <typeparam name="TData">循环列表数据类型。</typeparam>
public class UGLoopList<TData> : UGListBase<TData, LoopAdapter<TData>> where TData : ISimpleViewData, new()
{
/// <summary>
/// 初始化循环列表。
/// </summary>
/// <param name="recyclerView">目标 RecyclerView。</param>
public UGLoopList(RecyclerView recyclerView)
: base(recyclerView, new LoopAdapter<TData>(recyclerView))
{
}
}
/// <summary>
/// 提供多模板列表的便捷封装。
/// </summary>
/// <typeparam name="TData">多模板列表数据类型。</typeparam>
public class UGMixedList<TData> : UGListBase<TData, MixedAdapter<TData>> where TData : IMixedViewData
{
/// <summary>
/// 初始化多模板列表。
/// </summary>
/// <param name="recyclerView">目标 RecyclerView。</param>
public UGMixedList(RecyclerView recyclerView)
: base(recyclerView, new MixedAdapter<TData>(recyclerView))
{
}
}
/// <summary>
/// 提供常用 UGList 类型的快速创建方法。
/// </summary>
public static class UGListCreateHelper
{
/// <summary>
/// 创建单模板列表封装。
/// </summary>
/// <typeparam name="TData">列表数据类型。</typeparam>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <returns>创建后的单模板列表实例。</returns>
public static UGList<TData> Create<TData>(RecyclerView recyclerView) where TData : ISimpleViewData
=> new UGList<TData>(recyclerView);
/// <summary>
/// 创建分组列表封装。
/// </summary>
/// <typeparam name="TData">分组列表数据类型。</typeparam>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <param name="groupViewName">分组头使用的模板名称。</param>
/// <returns>创建后的分组列表实例。</returns>
public static UGGroupList<TData> CreateGroup<TData>(RecyclerView recyclerView, string groupViewName) where TData : class, IGroupViewData, new()
=> new UGGroupList<TData>(recyclerView, groupViewName);
/// <summary>
/// 创建循环列表封装。
/// </summary>
/// <typeparam name="TData">循环列表数据类型。</typeparam>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <returns>创建后的循环列表实例。</returns>
public static UGLoopList<TData> CreateLoop<TData>(RecyclerView recyclerView) where TData : ISimpleViewData, new()
=> new UGLoopList<TData>(recyclerView);
/// <summary>
/// 创建多模板列表封装。
/// </summary>
/// <typeparam name="TData">多模板列表数据类型。</typeparam>
/// <param name="recyclerView">目标 RecyclerView。</param>
/// <returns>创建后的多模板列表实例。</returns>
public static UGMixedList<TData> CreateMixed<TData>(RecyclerView recyclerView) where TData : IMixedViewData
=> new UGMixedList<TData>(recyclerView);
}

10
Runtime/RecyclerView/UGList.cs.meta
View File

@ -1,11 +1,3 @@
fileFormatVersion: 2
guid: fd094e3cb2194cb193221ea9436a169a
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
timeCreated: 1766729620

16
Runtime/RecyclerView/UGListExtensions.cs
View File

@ -8,6 +8,9 @@ namespace AlicizaX.UI
/// </summary>
public static class UGListExtensions
{
/// <summary>
/// 控制是否输出滚动定位调试日志。
/// </summary>
public static bool DebugScrollTo { get; set; } = false;
/// <summary>
@ -37,7 +40,12 @@ namespace AlicizaX.UI
return;
}
ugList.ScrollTo(index, alignment, offset, smooth, duration);
if (DebugScrollTo)
{
Debug.Log($"[UGListExtensions] ScrollTo: index={index}, alignment={alignment}, offset={offset}, smooth={smooth}, duration={duration}");
}
ugList.RecyclerView.ScrollToWithAlignment(index, alignment, offset, smooth, duration);
}
/// <summary>
@ -59,7 +67,7 @@ namespace AlicizaX.UI
where TAdapter : Adapter<TData>
where TData : ISimpleViewData
{
ugList.ScrollToStart(index, offset, smooth, duration);
ugList.ScrollTo(index, ScrollAlignment.Start, offset, smooth, duration);
}
/// <summary>
@ -81,7 +89,7 @@ namespace AlicizaX.UI
where TAdapter : Adapter<TData>
where TData : ISimpleViewData
{
ugList.ScrollToCenter(index, offset, smooth, duration);
ugList.ScrollTo(index, ScrollAlignment.Center, offset, smooth, duration);
}
/// <summary>
@ -103,7 +111,7 @@ namespace AlicizaX.UI
where TAdapter : Adapter<TData>
where TData : ISimpleViewData
{
ugList.ScrollToEnd(index, offset, smooth, duration);
ugList.ScrollTo(index, ScrollAlignment.End, offset, smooth, duration);
}
}
}