表格设置单元格为预制体的情况下不会刷新这个预制体,因为条件写反了。

This commit is contained in:
2026-07-30 14:58:12 +08:00
parent a5616b6a06
commit f7931d41f1
8 changed files with 272 additions and 223 deletions
@@ -1,3 +1,4 @@
using System.Collections.Generic;
using TMPro;
using UnityEngine;
@@ -7,7 +8,7 @@ namespace XericUI.XTable.Rendering.Elements
{
/// <summary>
/// 表格单元动态拼装器——通过 SlotCounterPool 管理 Image + TMP_Text 的组合创建与回收。
/// 每个单元格通过 cellId 映射到固定索引的计数器槽位,空闲槽位经 FrozenSlots 全局流转复用。
/// cellId 在绑定期间稳定复用同一对象;对象显隐仅随所属 Counter 整体借出或归还变更。
/// 所有元素统一使用 anchor=(0,1) pivot=(0,1) 左上角坐标系。
/// 所有动态生成对象标记 HideFlags.DontSave | HideFlags.HideInHierarchy,防止泄漏到场景。
/// </summary>
@@ -21,7 +22,6 @@ namespace XericUI.XTable.Rendering.Elements
public RectTransform Rect;
public Image Image;
public StyleBoundElement Style;
/// <summary>绑定的单元格 ID,用于 Release 定位槽位</summary>
public int CellId;
}
@@ -31,7 +31,6 @@ namespace XericUI.XTable.Rendering.Elements
public RectTransform Rect;
public TMP_Text Text;
public StyleBoundElement Style;
/// <summary>绑定的单元格 ID,用于 Release 定位槽位</summary>
public int CellId;
}
@@ -40,19 +39,10 @@ namespace XericUI.XTable.Rendering.Elements
#region 字段
private Transform m_Parent;
/// <summary>运行时的默认样式命名空间(编辑器下为 null,不绑定)</summary>
private string m_DefaultStyleNamespace;
/// <summary>所有已绑定的 StyleBoundElement 回调集合(用于样式变更时通知外部)</summary>
public event System.Action OnStyleChangeDetected;
/// <summary>基于计数器的 Image 槽位对象池</summary>
private SlotCounterPool<PooledImage> m_ImagePool;
/// <summary>基于计数器的 Text 槽位对象池</summary>
private SlotCounterPool<PooledText> m_TextPool;
/// <summary>HideFlags 应用于所有动态创建的对象(不保存、不在 Hierarchy 显示)</summary>
private const HideFlags POOL_FLAGS = HideFlags.DontSave | HideFlags.HideInHierarchy;
#endregion
@@ -63,11 +53,13 @@ namespace XericUI.XTable.Rendering.Elements
{
m_Parent = parent;
m_DefaultStyleNamespace = defaultStyleNamespace;
m_ImagePool = new SlotCounterPool<PooledImage>(() => CreateImage("cell_img"));
m_TextPool = new SlotCounterPool<PooledText>(() => CreateText("cell_text"));
m_ImagePool = new SlotCounterPool<PooledImage>(() => CreateImage("cell_img"),
SetImageCounterActive, SetImageCounterInactive);
m_TextPool = new SlotCounterPool<PooledText>(() => CreateText("cell_text"),
SetTextCounterActive, SetTextCounterInactive);
}
/// <summary>彻底销毁所有池对象(包括计数器内活跃槽位和冻结槽位)</summary>
/// <summary>彻底销毁所有池对象。</summary>
public void DestroyAll()
{
m_ImagePool.DestroyAll(item => KillObject(item.Root));
@@ -95,48 +87,57 @@ namespace XericUI.XTable.Rendering.Elements
#region 池操作
/// <summary>为指定 cellId 获取一个池化 Image</summary>
/// <summary>为指定 cellId 获取池化 Image;已有绑定原样返回。</summary>
public PooledImage GetImage(int cellId, string name = "cell_img", string styleNamespace = null,
Transform parent = null)
{
var item = m_ImagePool.Acquire(cellId);
var item = m_ImagePool.Acquire(cellId, out bool isNewBinding);
if (item == null) return null;
if (!isNewBinding)
{
if (parent != null && item.Root.transform.parent != parent)
item.Root.transform.SetParent(parent, false);
BindStyle(item.Style, styleNamespace);
return item;
}
if (parent != null && item.Root.transform.parent != parent)
item.Root.transform.SetParent(parent, false);
item.CellId = cellId;
item.Root.SetActive(true);
item.Root.name = name;
ResetImageDefaults(item);
BindStyle(item.Style, styleNamespace);
return item;
}
/// <summary>为指定 cellId 获取一个池化 TMP_Text</summary>
/// <summary>为指定 cellId 获取池化 TMP_Text;已有绑定原样返回。</summary>
public PooledText GetText(int cellId, string name = "cell_text", string styleNamespace = null,
Transform parent = null)
{
var item = m_TextPool.Acquire(cellId);
var item = m_TextPool.Acquire(cellId, out bool isNewBinding);
if (item == null) return null;
if (!isNewBinding)
{
if (parent != null && item.Root.transform.parent != parent)
item.Root.transform.SetParent(parent, false);
BindStyle(item.Style, styleNamespace);
return item;
}
if (parent != null && item.Root.transform.parent != parent)
item.Root.transform.SetParent(parent, false);
item.CellId = cellId;
item.Root.SetActive(true);
item.Root.name = name;
ResetTextDefaults(item);
BindStyle(item.Style, styleNamespace);
return item;
}
/// <summary>运行时绑定样式到池元素的 StyleBoundElement,实现被动更新(push)</summary>
private void BindStyle(StyleBoundElement style, string cellNamespace)
{
if (!Application.isPlaying) return;
string ns = cellNamespace ?? m_DefaultStyleNamespace;
if (string.IsNullOrEmpty(ns)) return;
if (style != null && style.BoundNamespace != ns)
{
style.OnStyleChangedCallback -= OnStyleChangedNotify;
@@ -150,39 +151,64 @@ namespace XericUI.XTable.Rendering.Elements
OnStyleChangeDetected?.Invoke();
}
/// <summary>归还所有槽位(全量刷新时调用)。被归还对象会隐藏,直到下次 Acquire。</summary>
/// <summary>解除指定 cellId 的 Image 与 Text 槽位绑定。</summary>
public void ReleaseCell(int cellId)
{
m_ImagePool.ReleaseCell(cellId);
m_TextPool.ReleaseCell(cellId);
}
/// <summary>解除全部 Image 与 Text 槽位绑定。</summary>
public void ReleaseAllBindings()
{
m_ImagePool.ReleaseAllBindings();
m_TextPool.ReleaseAllBindings();
}
/// <summary>兼容旧 API:解除全部槽位绑定。</summary>
public void ReturnAll()
{
m_ImagePool.ReturnAll(HideImage);
m_TextPool.ReturnAll(HideText);
ReleaseAllBindings();
}
/// <summary>归还单个 Image 池对象并隐藏。</summary>
/// <summary>解除指定 Image 的槽位绑定;显隐仅在所属 Counter 完整归还时变更。</summary>
public void ReleaseImage(PooledImage item)
{
if (item == null) return;
HideImage(item);
m_ImagePool.ReleaseByObject(item);
if (item != null) m_ImagePool.ReleaseCell(item.CellId);
}
/// <summary>归还单个 Text 池对象并隐藏。</summary>
/// <summary>解除指定 Text 的槽位绑定;显隐仅在所属 Counter 完整归还时变更。</summary>
public void ReleaseText(PooledText item)
{
if (item == null) return;
HideText(item);
m_TextPool.ReleaseByObject(item);
if (item != null) m_TextPool.ReleaseCell(item.CellId);
}
private static void HideImage(PooledImage item)
private static void SetImageCounterActive(IReadOnlyList<PooledImage> items)
{
item.Style?.Unbind();
item.Root.SetActive(false);
for (int i = 0; i < items.Count; i++) items[i].Root.SetActive(true);
}
private static void HideText(PooledText item)
private static void SetImageCounterInactive(IReadOnlyList<PooledImage> items)
{
item.Style?.Unbind();
item.Root.SetActive(false);
for (int i = 0; i < items.Count; i++)
{
items[i].Style?.Unbind();
items[i].Root.SetActive(false);
}
}
private static void SetTextCounterActive(IReadOnlyList<PooledText> items)
{
for (int i = 0; i < items.Count; i++) items[i].Root.SetActive(true);
}
private static void SetTextCounterInactive(IReadOnlyList<PooledText> items)
{
for (int i = 0; i < items.Count; i++)
{
items[i].Style?.Unbind();
items[i].Root.SetActive(false);
}
}
#endregion
@@ -228,19 +254,11 @@ namespace XericUI.XTable.Rendering.Elements
Image img = go.GetComponent<Image>();
img.raycastTarget = false;
RectTransform rect = go.GetComponent<RectTransform>();
rect.anchorMin = ANCHOR_TOPLEFT_MIN;
rect.anchorMax = ANCHOR_TOPLEFT_MAX;
rect.pivot = PIVOT_TOPLEFT;
return new PooledImage
{
Root = go,
Rect = rect,
Image = img,
Style = new StyleBoundElement { ImageComponent = img }
};
return new PooledImage { Root = go, Rect = rect, Image = img, Style = new StyleBoundElement { ImageComponent = img } };
}
private PooledText CreateText(string name)
@@ -254,19 +272,11 @@ namespace XericUI.XTable.Rendering.Elements
text.raycastTarget = false;
text.alignment = TextAlignmentOptions.Midline;
text.fontSize = 14;
RectTransform rect = go.GetComponent<RectTransform>();
rect.anchorMin = ANCHOR_TOPLEFT_MIN;
rect.anchorMax = ANCHOR_TOPLEFT_MAX;
rect.pivot = PIVOT_TOPLEFT;
return new PooledText
{
Root = go,
Rect = rect,
Text = text,
Style = new StyleBoundElement { TextComponent = text }
};
return new PooledText { Root = go, Rect = rect, Text = text, Style = new StyleBoundElement { TextComponent = text } };
}
#endregion