435 lines
13 KiB
C#
435 lines
13 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using UnityEngine;
|
||
using UnityEngine.Pool;
|
||
|
||
namespace XericUI.ReflectionUIGenerator
|
||
{
|
||
/// <summary>
|
||
/// 字段 Entry 接口
|
||
/// 数据对象字段与 UI 组件之间的中间缓存层
|
||
/// </summary>
|
||
public interface IFieldEntry
|
||
{
|
||
/// <summary>Entry 名称（字段名或编组路径）</summary>
|
||
string EntryName { get; }
|
||
|
||
/// <summary>Entry 完整路径（含父级路径）</summary>
|
||
string EntryPath { get; }
|
||
|
||
/// <summary>主要功能标记</summary>
|
||
XuiavrgFieldTag Tag { get; }
|
||
|
||
/// <summary>标记索引</summary>
|
||
int TagIndex { get; }
|
||
|
||
/// <summary>排序值（越小越靠前）</summary>
|
||
int FieldOrder { get; set; }
|
||
|
||
/// <summary>是否为编组 Entry（包含子 Entry）</summary>
|
||
bool IsGroupEntry { get; }
|
||
|
||
/// <summary>父 Entry</summary>
|
||
IFieldEntry Parent { get; }
|
||
|
||
/// <summary>子 Entry 列表（只读）</summary>
|
||
IReadOnlyList<IFieldEntry> Children { get; }
|
||
|
||
/// <summary>生成的 UI 实例引用</summary>
|
||
GameObject UIInstance { get; }
|
||
|
||
/// <summary>绑定的预制体引用</summary>
|
||
GameObject BoundPrefab { get; set; }
|
||
|
||
/// <summary>覆盖的预制体组名称</summary>
|
||
string PrefabOverrideName { get; set; }
|
||
|
||
/// <summary>关联的 MVVM 绑定列表</summary>
|
||
IReadOnlyList<AvrgMvvmBinding> Bindings { get; }
|
||
|
||
// === 生命周期 ===
|
||
|
||
/// <summary>Entry 创建时调用</summary>
|
||
void OnEntryCreate();
|
||
|
||
/// <summary>绑定 UI 和数据时调用</summary>
|
||
void OnEntryBind();
|
||
|
||
/// <summary>释放时调用（归还池前）</summary>
|
||
void OnEntryRelease();
|
||
|
||
/// <summary>销毁时调用</summary>
|
||
void OnEntryDestroy();
|
||
|
||
// === 绑定管理 ===
|
||
|
||
/// <summary>添加 MVVM 绑定到此 Entry</summary>
|
||
void AddBinding(AvrgMvvmBinding binding, AvrgMvvmScheduler scheduler);
|
||
|
||
// === UI 绑定 ===
|
||
|
||
/// <summary>
|
||
/// 绑定 UI 组件
|
||
/// </summary>
|
||
void BindUIComponent(GameObject uiInstance, List<Component> componentCache);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 字段临时 Entry 实现类
|
||
/// 作为数据对象和 UI 组件之间的中间缓存层
|
||
/// </summary>
|
||
public class XuiFieldTempEntry : IFieldEntry
|
||
{
|
||
#region 对象池
|
||
|
||
internal static ObjectPool<XuiFieldTempEntry> Pool { get; private set; }
|
||
|
||
static XuiFieldTempEntry()
|
||
{
|
||
Pool = new ObjectPool<XuiFieldTempEntry>(
|
||
createFunc: () => new XuiFieldTempEntry(),
|
||
actionOnGet: entry => entry.OnEntryCreate(),
|
||
actionOnRelease: entry => entry.OnEntryRelease(),
|
||
actionOnDestroy: entry => entry.OnEntryDestroy(),
|
||
collectionCheck: false,
|
||
defaultCapacity: 32,
|
||
maxSize: 512
|
||
);
|
||
}
|
||
|
||
/// <summary>从池中获取 Entry 实例</summary>
|
||
public static XuiFieldTempEntry Get() => Pool.Get();
|
||
|
||
/// <summary>将 Entry 归还池中</summary>
|
||
public static void Release(XuiFieldTempEntry entry) => Pool.Release(entry);
|
||
|
||
#endregion
|
||
|
||
#region 字段
|
||
|
||
private string _entryName;
|
||
private string _entryPath;
|
||
private IFieldEntry _parent;
|
||
private List<XuiFieldTempEntry> _children = new List<XuiFieldTempEntry>();
|
||
private List<AvrgMvvmBinding> _bindings = new List<AvrgMvvmBinding>();
|
||
private AvrgMvvmScheduler _scheduler;
|
||
private GameObject _uiInstance;
|
||
private GameObject _boundPrefab;
|
||
private string _prefabOverrideName;
|
||
private int _fieldOrder;
|
||
private bool _uiBound; // 防止重复绑定
|
||
|
||
#endregion
|
||
|
||
#region IFieldEntry 属性实现
|
||
|
||
public string EntryName => _entryName;
|
||
|
||
public string EntryPath
|
||
{
|
||
get
|
||
{
|
||
if (!string.IsNullOrEmpty(_entryPath)) return _entryPath;
|
||
if (_parent != null)
|
||
{
|
||
string parentPath = _parent.EntryPath;
|
||
return string.IsNullOrEmpty(parentPath)
|
||
? _entryName
|
||
: parentPath + "/" + _entryName;
|
||
}
|
||
return _entryName;
|
||
}
|
||
}
|
||
|
||
public XuiavrgFieldTag Tag { get; private set; }
|
||
public int TagIndex { get; private set; }
|
||
|
||
public int FieldOrder
|
||
{
|
||
get => _fieldOrder;
|
||
set => _fieldOrder = value;
|
||
}
|
||
|
||
public bool IsGroupEntry => _children.Count > 0;
|
||
|
||
public IFieldEntry Parent => _parent;
|
||
|
||
public IReadOnlyList<IFieldEntry> Children => _children;
|
||
|
||
public GameObject UIInstance => _uiInstance;
|
||
|
||
public GameObject BoundPrefab
|
||
{
|
||
get => _boundPrefab;
|
||
set => _boundPrefab = value;
|
||
}
|
||
|
||
public string PrefabOverrideName
|
||
{
|
||
get => _prefabOverrideName;
|
||
set => _prefabOverrideName = value;
|
||
}
|
||
|
||
public IReadOnlyList<AvrgMvvmBinding> Bindings => _bindings;
|
||
|
||
#endregion
|
||
|
||
#region 初始化方法
|
||
|
||
/// <summary>
|
||
/// 设置 Entry 基本属性
|
||
/// </summary>
|
||
public void Initialize(string entryName, XuiavrgFieldTag tag = XuiavrgFieldTag.None, int tagIndex = 0)
|
||
{
|
||
_entryName = entryName;
|
||
_entryPath = null;
|
||
Tag = tag;
|
||
TagIndex = tagIndex;
|
||
_fieldOrder = 0;
|
||
_uiBound = false;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 设置父 Entry（用于嵌套）
|
||
/// </summary>
|
||
public void SetParent(IFieldEntry parent)
|
||
{
|
||
_parent = parent;
|
||
_entryPath = null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 添加子 Entry
|
||
/// </summary>
|
||
public void AddChild(XuiFieldTempEntry child)
|
||
{
|
||
if (child == null) return;
|
||
child.SetParent(this);
|
||
_children.Add(child);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 添加 MVVM 绑定到此 Entry
|
||
/// </summary>
|
||
public void AddBinding(AvrgMvvmBinding binding, AvrgMvvmScheduler scheduler)
|
||
{
|
||
if (binding == null) return;
|
||
_bindings.Add(binding);
|
||
_scheduler = scheduler;
|
||
|
||
if (Tag == XuiavrgFieldTag.None && binding.MetaData?.Tag != XuiavrgFieldTag.None)
|
||
{
|
||
Tag = binding.MetaData.Tag;
|
||
TagIndex = binding.MetaData.TagIndex;
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region UI 绑定
|
||
|
||
public void BindUIComponent(GameObject uiInstance, List<Component> componentCache)
|
||
{
|
||
_uiInstance = uiInstance;
|
||
if (_uiInstance == null || _uiBound) return;
|
||
|
||
if (componentCache == null)
|
||
{
|
||
componentCache = new List<Component>();
|
||
_uiInstance.GetComponentsInChildren(true, componentCache);
|
||
}
|
||
|
||
// 遍历组件缓存，寻找 XUIAvrgMDValue 按 Tag 匹配
|
||
foreach (var comp in componentCache)
|
||
{
|
||
if (comp is XUIAvrgMDValue mdValue)
|
||
{
|
||
if (mdValue.EntryTag == this.Tag &&
|
||
(this.TagIndex == 0 || mdValue.TagIndex == this.TagIndex))
|
||
{
|
||
BindComponentWithBinding(mdValue);
|
||
}
|
||
}
|
||
}
|
||
|
||
// 子 Entry 复用组件缓存
|
||
foreach (var child in _children)
|
||
{
|
||
child.BindUIComponent(_uiInstance, componentCache);
|
||
}
|
||
|
||
_uiBound = true;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 将 XUIAvrgMDValue 与 MVVM 绑定连接
|
||
/// </summary>
|
||
private void BindComponentWithBinding(XUIAvrgMDValue mdValue)
|
||
{
|
||
if (_bindings.Count == 0) return;
|
||
|
||
var primaryBinding = _bindings[0];
|
||
|
||
// 数据 → UI：订阅数据变更
|
||
primaryBinding.OnUIDataChanged += value => UpdateUIComponent(mdValue, value);
|
||
|
||
// UI → 数据：订阅 UI 交互事件
|
||
// 根据组件类型决定 UI 事件
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.Button uiButton))
|
||
{
|
||
uiButton.onClick.AddListener(() =>
|
||
{
|
||
primaryBinding.WriteFromUI(true);
|
||
_scheduler?.MarkUIDirty(primaryBinding);
|
||
});
|
||
}
|
||
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.Toggle uiToggle))
|
||
{
|
||
uiToggle.onValueChanged.AddListener(val =>
|
||
{
|
||
primaryBinding.WriteFromUI(val);
|
||
_scheduler?.MarkUIDirty(primaryBinding);
|
||
});
|
||
}
|
||
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.Slider uiSlider))
|
||
{
|
||
uiSlider.onValueChanged.AddListener(val =>
|
||
{
|
||
primaryBinding.WriteFromUI(val);
|
||
_scheduler?.MarkUIDirty(primaryBinding);
|
||
});
|
||
}
|
||
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.InputField uiInput))
|
||
{
|
||
uiInput.onEndEdit.AddListener(val =>
|
||
{
|
||
primaryBinding.WriteFromUI(val);
|
||
_scheduler?.MarkUIDirty(primaryBinding);
|
||
});
|
||
}
|
||
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.Dropdown uiDropdown))
|
||
{
|
||
uiDropdown.onValueChanged.AddListener(val =>
|
||
{
|
||
primaryBinding.WriteFromUI(val);
|
||
_scheduler?.MarkUIDirty(primaryBinding);
|
||
});
|
||
}
|
||
|
||
// 广播元数据到 XUIAvrgMDValue（触发 IXUIAvrgMDValueStyle 子组件）
|
||
mdValue.InitializeWithMetaData(primaryBinding.MetaData);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 更新 UI 组件的显示值（通过 XUIAvrgMDValue 所在 GameObject 上的具体组件）
|
||
/// </summary>
|
||
private static void UpdateUIComponent(XUIAvrgMDValue mdValue, object value)
|
||
{
|
||
if (mdValue == null || value == null) return;
|
||
|
||
// Text
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.Text uiText))
|
||
{
|
||
uiText.text = value.ToString();
|
||
return;
|
||
}
|
||
|
||
// Toggle
|
||
if (value is bool boolVal && mdValue.TryGetComponent(out UnityEngine.UI.Toggle uiToggle))
|
||
{
|
||
uiToggle.isOn = boolVal;
|
||
return;
|
||
}
|
||
|
||
// Slider
|
||
if (value is float floatVal && mdValue.TryGetComponent(out UnityEngine.UI.Slider uiSlider))
|
||
{
|
||
uiSlider.value = floatVal;
|
||
return;
|
||
}
|
||
|
||
// InputField
|
||
if (mdValue.TryGetComponent(out UnityEngine.UI.InputField uiInput))
|
||
{
|
||
uiInput.text = value.ToString();
|
||
return;
|
||
}
|
||
|
||
// Dropdown
|
||
if (value is int intVal && mdValue.TryGetComponent(out UnityEngine.UI.Dropdown uiDropdown))
|
||
{
|
||
uiDropdown.value = intVal;
|
||
return;
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 生命周期
|
||
|
||
public void OnEntryCreate()
|
||
{
|
||
_entryName = null;
|
||
_entryPath = null;
|
||
_parent = null;
|
||
_fieldOrder = 0;
|
||
_prefabOverrideName = null;
|
||
_uiBound = false;
|
||
}
|
||
|
||
public void OnEntryBind()
|
||
{
|
||
foreach (var binding in _bindings)
|
||
{
|
||
var value = binding.ReadFromDataSource();
|
||
binding.NotifyUIUpdate(value);
|
||
}
|
||
}
|
||
|
||
public void OnEntryRelease()
|
||
{
|
||
_entryName = null;
|
||
_entryPath = null;
|
||
_parent = null;
|
||
_uiInstance = null;
|
||
_boundPrefab = null;
|
||
_prefabOverrideName = null;
|
||
Tag = XuiavrgFieldTag.None;
|
||
TagIndex = 0;
|
||
_fieldOrder = 0;
|
||
_uiBound = false;
|
||
|
||
foreach (var binding in _bindings)
|
||
{
|
||
binding.ClearUIEvent();
|
||
}
|
||
_bindings.Clear();
|
||
_scheduler = null;
|
||
|
||
foreach (var child in _children)
|
||
{
|
||
Release(child);
|
||
}
|
||
_children.Clear();
|
||
}
|
||
|
||
public void OnEntryDestroy()
|
||
{
|
||
foreach (var binding in _bindings)
|
||
{
|
||
binding.ClearUIEvent();
|
||
}
|
||
_bindings.Clear();
|
||
_children.Clear();
|
||
_uiInstance = null;
|
||
_scheduler = null;
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
}
|