- Awake 与三个重建入口不再"先清空再重建",改走 ReconcileGeneratedHierarchy:模板、背景、 边框、冻结层逐项检查,存在就复用(各自重置 rect 与内容),缺了才建。编辑模式下预制体实例 里的对象本来就不能 DestroyImmediate,这条路径也顺手绕开了它。 - 池的四个显隐回调与 ReleaseAllTrackedCells 跳过已销毁的根:手工删过生成物之后, ReturnCounter 会把已销毁对象交给 SetActive,抛 MissingReferenceException。 - XTableBackgroundRenderer 的图元坐标按 rectTransform.rect 换算:本地原点是轴心、图元坐标是 左上角原点,以前只在 pivot=(0,1) 时重合;现在轴心是什么都对,不再依赖调用方先摆好 pivot。
513 lines
20 KiB
C#
513 lines
20 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using TMPro;
|
||
using UnityEngine;
|
||
using UnityEngine.EventSystems;
|
||
using UnityEngine.UI;
|
||
using XericUI.Core.Base;
|
||
// 守卫外:下面 [AddComponentMenu(XericRegistrationPaths.Table + …)] 的参数玩家编译也要算出常量
|
||
using XericUI.Core;
|
||
using XericUI.XTable.Core;
|
||
using XericUI.XTable.Mapping;
|
||
using XericUI.XTable.Rendering.Elements;
|
||
using XericLibrary.Runtime.SuperStyleSheet;
|
||
using XericLibrary.Runtime.UIGraph;
|
||
#if UNITY_EDITOR
|
||
using UnityEditor;
|
||
#endif
|
||
|
||
namespace XericUI.XTable.Rendering.Component
|
||
{
|
||
/// <summary>
|
||
/// 表格组件——纯数据渲染器。
|
||
/// 一张全幅背景 + 按需拼装单元格文本/图片。
|
||
/// 无行列标题、无样式差异分割线——所有内容由数据定义。
|
||
/// </summary>
|
||
[ExecuteAlways]
|
||
[AddComponentMenu(XericRegistrationPaths.Table + "/Xeric UI Action Table", 60)]
|
||
public partial class XericUIActionTable : XericUIBehaviour
|
||
{
|
||
#region 序列化字段
|
||
|
||
[SerializeField] private XTableData m_TableData;
|
||
|
||
[SerializeField] private float[] m_RowHeights = new float[] { 40f, 30f };
|
||
|
||
[SerializeField] private float[] m_ColWidths = new float[] { 100f, 80f, 120f };
|
||
|
||
[SerializeField] private string m_DefaultStyleNamespace = "";
|
||
|
||
[SerializeField]
|
||
[Tooltip("表格全局配置资源")]
|
||
private XTableConfig m_Config;
|
||
|
||
[SerializeField] private ScrollRect m_ScrollRect;
|
||
|
||
[SerializeField]
|
||
[Tooltip("冻结行数——顶部固定不滚动的行数")]
|
||
private int m_FreezeRowCount;
|
||
|
||
[SerializeField]
|
||
[Tooltip("冻结列数——左侧固定不滚动的列数")]
|
||
private int m_FreezeColCount;
|
||
|
||
[SerializeField]
|
||
[Tooltip("在 Hierarchy 中显示动态生成的子对象(仅编辑器,不保存到场景)")]
|
||
private bool m_ChildrenVisible;
|
||
|
||
[SerializeField] private bool m_EnableSelectionAutoScroll = true;
|
||
[SerializeField, Min(1f), Tooltip("框选自动滚动的 Content 边缘阈值(像素)")]
|
||
private float m_SelectionAutoScrollEdgeThreshold = 32f;
|
||
[SerializeField, Min(1f), Tooltip("框选自动滚动的最大速度(像素/秒)")]
|
||
private float m_SelectionAutoScrollMaxSpeed = 600f;
|
||
[SerializeField, Min(1f), Tooltip("框选自动滚动的边缘加速度指数")]
|
||
private float m_SelectionAutoScrollAcceleration = 1.5f;
|
||
|
||
#endregion
|
||
|
||
#region 私有字段
|
||
|
||
[System.NonSerialized] private CellAssembler m_Assembler;
|
||
[System.NonSerialized] private XTableDirtyFlag m_DirtyFlag;
|
||
|
||
/// <summary>Viewport 下的冻结列、冻结行与左上交叉区渲染器。</summary>
|
||
[System.NonSerialized] private TableRenderer m_FrozenColumnRenderer;
|
||
[System.NonSerialized] private TableRenderer m_FrozenRowRenderer;
|
||
[System.NonSerialized] private TableRenderer m_FrozenCornerRenderer;
|
||
[System.NonSerialized] private RectTransform m_FrozenColumnsContainer;
|
||
[System.NonSerialized] private RectTransform m_FrozenRowsContainer;
|
||
[System.NonSerialized] private RectTransform m_FrozenCornerContainer;
|
||
|
||
[System.NonSerialized] private XTableSelectionHandle m_SelectionHandle;
|
||
[System.NonSerialized] private XTableSelectionOverlay m_NormalSelectionOverlay;
|
||
[System.NonSerialized] private XTableSelectionOverlay m_FrozenColumnSelectionOverlay;
|
||
[System.NonSerialized] private XTableSelectionOverlay m_FrozenRowSelectionOverlay;
|
||
[System.NonSerialized] private XTableSelectionOverlay m_FrozenCornerSelectionOverlay;
|
||
[System.NonSerialized] private bool m_SelectionDragActive;
|
||
[System.NonSerialized] private Vector2 m_LastSelectionPointer;
|
||
[System.NonSerialized] private Camera m_SelectionPointerCamera;
|
||
|
||
[System.NonSerialized] private XTableBackgroundRenderer m_BackgroundRenderer;
|
||
|
||
/// <summary>
|
||
/// content / 冻结容器这些“预制体自己的 RectTransform”由本组件驱动。
|
||
/// 走 DrivenRectTransformTracker 写入的几何不会落序列化、也不会被记成预制体修改;
|
||
/// 直接赋值则编辑模式每次刷新都会把表尺寸写进预制体(表现为“预制体坐标尺寸自己变了”)。
|
||
/// </summary>
|
||
[System.NonSerialized] private DrivenRectTransformTracker m_LayoutDriven;
|
||
|
||
/// <summary>预制体对象池——按原型分组管理</summary>
|
||
[System.NonSerialized] private PrefabPrototypePool m_PrefabPool;
|
||
|
||
/// <summary>活跃预制体实例映射 (row, col) → instance,用于回调编排</summary>
|
||
[System.NonSerialized] private Dictionary<(int, int), GameObject> m_ActivePrefabMap;
|
||
|
||
/// <summary>Texture2D → Sprite 缓存,避免每帧 Sprite.Create 分配</summary>
|
||
[System.NonSerialized] private Dictionary<Texture2D, Sprite> m_SpriteCache;
|
||
|
||
/// <summary>表格四叉树——仅多样式背景分区时按需构建</summary>
|
||
[System.NonSerialized] private XTableQuadtree m_Quadtree;
|
||
[System.NonSerialized] private bool m_QuadtreeDirty = true;
|
||
[System.NonSerialized] private readonly HashSet<string> m_ActiveStyleNamespaces = new();
|
||
[System.NonSerialized] private bool m_StyleNamespaceDirty = true;
|
||
|
||
/// <summary>各渲染区域的边框线段渲染器。</summary>
|
||
[System.NonSerialized] private UILineRendererV2 m_BorderRenderer;
|
||
[System.NonSerialized] private UILineRendererV2 m_FrozenColumnBorderRenderer;
|
||
[System.NonSerialized] private UILineRendererV2 m_FrozenRowBorderRenderer;
|
||
[System.NonSerialized] private UILineRendererV2 m_FrozenCornerBorderRenderer;
|
||
|
||
[NonSerialized] private float[] m_ResolvedRowHeights;
|
||
[NonSerialized] private float[] m_ResolvedColWidths;
|
||
[NonSerialized] private Vector2 m_LastLayoutBaseSize;
|
||
|
||
private float m_TotalWidth;
|
||
private float m_TotalHeight;
|
||
|
||
/// <summary>内容偏移量(边框半宽),避免 viewport 裁切边缘边框</summary>
|
||
private float m_ContentOffset;
|
||
|
||
// ScrollRect 可见范围
|
||
private Rect m_VisibleRect;
|
||
|
||
#endregion
|
||
|
||
#region 事件
|
||
|
||
public event Action<int, int> OnCellSelected;
|
||
public event Action OnTableRefreshed;
|
||
|
||
#endregion
|
||
|
||
#region 公开属性
|
||
|
||
public XTableData TableData
|
||
{
|
||
get
|
||
{
|
||
if (m_TableData == null)
|
||
m_TableData = new XTableData();
|
||
return m_TableData;
|
||
}
|
||
set
|
||
{
|
||
m_TableData = value;
|
||
MarkDirty(TableDirtyType.DataChanged);
|
||
}
|
||
}
|
||
|
||
public XTableCellData this[int row, int col] => TableData.GetOrCreateCell(row, col);
|
||
|
||
public float[] RowHeights => m_RowHeights;
|
||
public float[] ColWidths => m_ColWidths;
|
||
public float[] ResolvedRowHeights => m_ResolvedRowHeights;
|
||
public float[] ResolvedColWidths => m_ResolvedColWidths;
|
||
|
||
/// <summary>冻结行数</summary>
|
||
public int FreezeRowCount => m_FreezeRowCount;
|
||
/// <summary>冻结列数</summary>
|
||
public int FreezeColCount => m_FreezeColCount;
|
||
|
||
public string DefaultStyleNamespace => m_DefaultStyleNamespace;
|
||
|
||
/// <summary>选中操作句柄——外部可通过此句柄控制选区,或直接操作 StartRow/StartCol 等属性</summary>
|
||
public XTableSelectionHandle SelectionHandle
|
||
{
|
||
get
|
||
{
|
||
if (m_SelectionHandle == null)
|
||
{
|
||
m_SelectionHandle = new XTableSelectionHandle();
|
||
m_SelectionHandle.OnSelectionChanged += OnHandleSelectionChanged;
|
||
}
|
||
return m_SelectionHandle;
|
||
}
|
||
}
|
||
|
||
// ── 向后兼容属性(供 Editor 脚本使用)──
|
||
public int SelectedRow => SelectionHandle.StartRow;
|
||
public int SelectedCol => SelectionHandle.StartCol;
|
||
public int SelectStartRow => SelectionHandle.StartRow;
|
||
public int SelectStartCol => SelectionHandle.StartCol;
|
||
public int SelectEndRow => SelectionHandle.EndRow;
|
||
public int SelectEndCol => SelectionHandle.EndCol;
|
||
public bool HasMultiSelection => SelectionHandle.HasMultiSelection;
|
||
|
||
/// <summary>动态子对象在 Hierarchy 中是否可见(仅编辑器有效)</summary>
|
||
public bool ChildrenVisible
|
||
{
|
||
get => m_ChildrenVisible;
|
||
set => SetChildrenVisible(value);
|
||
}
|
||
|
||
/// <summary>动态子对象挂载的父节点。
|
||
/// 若绑定了 ScrollRect 则使用其 Content,否则回退到自身的 rectTransform。</summary>
|
||
public Transform ContentTransform
|
||
{
|
||
get
|
||
{
|
||
if (m_ScrollRect != null && m_ScrollRect.content != null)
|
||
return m_ScrollRect.content;
|
||
return rectTransform;
|
||
}
|
||
}
|
||
|
||
/// <summary>表格全局配置资源</summary>
|
||
public XTableConfig Config
|
||
{
|
||
get
|
||
{
|
||
if (m_Config == null)
|
||
m_Config = XTableConfig.LoadOrDefault();
|
||
return m_Config;
|
||
}
|
||
set => m_Config = value;
|
||
}
|
||
|
||
/// <summary>单元格内容水平内边距(单侧)</summary>
|
||
private float CellPadding => Config.CellHorizontalPadding;
|
||
|
||
private void CreatePools()
|
||
{
|
||
m_Assembler = new CellAssembler(ContentTransform, m_DefaultStyleNamespace,
|
||
Config.TextPoolMaxCapacity, Config.ImagePoolMaxCapacity,
|
||
Config.TextPoolRouteBucketCount, Config.ImagePoolRouteBucketCount);
|
||
m_PrefabPool = new PrefabPrototypePool(ContentTransform, Config.PrefabPoolMaxCapacity);
|
||
}
|
||
|
||
/// <summary>单元格内容宽度扣除量</summary>
|
||
private float CellPadding2 => Config.CellHorizontalPadding * 2f;
|
||
|
||
/// <summary>判断单元格是否在多选范围内</summary>
|
||
public bool IsInSelectionRange(int row, int col)
|
||
{
|
||
return SelectionHandle.IsInRange(row, col);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 生命周期
|
||
|
||
private static bool s_StyleSheetsPreloaded;
|
||
|
||
/// <summary>
|
||
/// 预加载 Resources 目录下所有 XericStyleSheet 资产到 StyleManager。
|
||
/// 仅首次调用生效,后续调用直接跳过。
|
||
/// </summary>
|
||
private static void PreloadAllStyleSheets()
|
||
{
|
||
if (s_StyleSheetsPreloaded) return;
|
||
s_StyleSheetsPreloaded = true;
|
||
|
||
var sheets = Resources.LoadAll<XericStyleSheet>("");
|
||
foreach (var sheet in sheets)
|
||
{
|
||
if (sheet != null)
|
||
StyleManager.LoadStyleSheet(sheet);
|
||
}
|
||
}
|
||
|
||
protected override void Awake()
|
||
{
|
||
base.Awake();
|
||
|
||
// 预加载 Resources 中所有 .xsss 样式表到 StyleManager(仅首次)
|
||
PreloadAllStyleSheets();
|
||
|
||
// 逐项对齐:ScrollRect 模板、背景、边框、冻结层——存在就复用,缺了才建。
|
||
// 不再"先清空再重建":编辑模式下预制体实例里的对象不能 DestroyImmediate,
|
||
// 手工删过之后池里还会留下已销毁的引用。
|
||
ReconcileGeneratedHierarchy();
|
||
|
||
if (m_Config == null)
|
||
m_Config = XTableConfig.LoadOrDefault();
|
||
|
||
if (string.IsNullOrEmpty(m_DefaultStyleNamespace))
|
||
m_DefaultStyleNamespace = Config.DefaultStyleNamespace;
|
||
|
||
if (m_TableData == null)
|
||
m_TableData = new XTableData();
|
||
|
||
// 强制 Content 的 anchor/pivot 为 (0,1),确保 anchoredPosition 语义一致。
|
||
// 若不固定,ScrollRect 可能改变 anchor 导致坐标计算错误。
|
||
if (m_ScrollRect != null && m_ScrollRect.content != null)
|
||
{
|
||
RectTransform ct = m_ScrollRect.content as RectTransform;
|
||
if (ct != null)
|
||
{
|
||
ct.anchorMin = new Vector2(0, 1);
|
||
ct.anchorMax = new Vector2(0, 1);
|
||
ct.pivot = new Vector2(0, 1);
|
||
}
|
||
}
|
||
|
||
CreatePools();
|
||
m_ActivePrefabMap = new Dictionary<(int, int), GameObject>();
|
||
UpdateResolvedCellSizes();
|
||
RecalculateTotalSize();
|
||
EnsureDefaultStyleNamespace();
|
||
CreateDefaultSampleData();
|
||
CreateBackground();
|
||
|
||
// 创建 Viewport 层渲染器(用于冻结单元格)
|
||
CreateViewportRenderer();
|
||
|
||
if (m_ScrollRect != null)
|
||
m_ScrollRect.onValueChanged.AddListener(OnScrollValueChanged);
|
||
|
||
if (!Application.isPlaying)
|
||
SubscribeEditorUpdate();
|
||
else
|
||
m_Assembler.OnStyleChangeDetected += OnPoolStyleChanged;
|
||
|
||
MarkDirty(TableDirtyType.All);
|
||
}
|
||
|
||
protected override void OnEnable()
|
||
{
|
||
base.OnEnable();
|
||
EnsureDefaultStyleNamespace();
|
||
MarkDirty(TableDirtyType.All);
|
||
}
|
||
|
||
#if UNITY_EDITOR
|
||
protected override void OnValidate()
|
||
{
|
||
base.OnValidate();
|
||
// 编辑器下属性变更 / 选中组件时即刻刷新样式
|
||
MarkDirty(TableDirtyType.All);
|
||
}
|
||
#endif
|
||
|
||
protected override void OnDisable()
|
||
{
|
||
base.OnDisable();
|
||
// 驱动属性必须在停用时显式清掉,否则 Unity 会报 tracker 里残留已销毁对象。
|
||
m_LayoutDriven.Clear();
|
||
}
|
||
|
||
protected override void OnDestroy()
|
||
{
|
||
if (m_ScrollRect != null)
|
||
m_ScrollRect.onValueChanged.RemoveListener(OnScrollValueChanged);
|
||
UnsubscribeEditorUpdate();
|
||
|
||
if (m_Assembler != null)
|
||
m_Assembler.OnStyleChangeDetected -= OnPoolStyleChanged;
|
||
|
||
// 销毁所有动态生成的对象
|
||
if (m_Assembler != null)
|
||
m_Assembler.DestroyAll();
|
||
m_PrefabPool?.DestroyAll();
|
||
m_ActivePrefabMap?.Clear();
|
||
DestroyBorderRenderer();
|
||
DestroyBackgroundRenderer();
|
||
|
||
DestroyFrozenRenderers();
|
||
DestroySelectionOverlay(ref m_NormalSelectionOverlay);
|
||
|
||
// ScrollRect 模板是我们生成的:组件删掉时连同 Viewport/Content/滚动条一起收掉,
|
||
// 否则 content 会带着里面的渲染器留在场景里(2026-11-13 现场)。
|
||
DestroyScrollTemplate();
|
||
|
||
base.OnDestroy();
|
||
}
|
||
|
||
/// <summary>是否正在同步重建中,此时 Update / EditorUpdate 应跳过以避免重入</summary>
|
||
[System.NonSerialized] private bool m_IsRebuilding;
|
||
|
||
private void Update()
|
||
{
|
||
UpdateSelectionAutoScroll();
|
||
if (m_IsRebuilding || IsCheckingUpdate || !m_DirtyFlag.IsDirty) return;
|
||
|
||
var flags = m_DirtyFlag.Flags;
|
||
// 仅滚动或选区变更 → 轻刷新(不重建边框/背景/预制体全回收)
|
||
if ((flags & ~(TableDirtyType.ScrollChanged | TableDirtyType.SelectionChanged)) == 0)
|
||
RefreshViewLight();
|
||
else
|
||
RefreshView();
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 默认示例数据
|
||
|
||
private void CreateDefaultSampleData()
|
||
{
|
||
// 仅当数据完全为空时才创建示例数据(首次使用或数据损坏后恢复)
|
||
if (m_TableData.BlockCount > 0) return;
|
||
|
||
string[,] sample = new string[2, 3]
|
||
{
|
||
{ "Name", "Age", "City" },
|
||
{ "Alice", "25", "NYC" }
|
||
};
|
||
|
||
for (int r = 0; r < 2; r++)
|
||
for (int c = 0; c < 3; c++)
|
||
{
|
||
var data = m_TableData.GetOrCreateCell(r, c);
|
||
data.Text = sample[r, c];
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 脏标记与滚动回调
|
||
|
||
public void MarkDirty(TableDirtyType type)
|
||
{
|
||
if (IsCheckingUpdate)
|
||
{
|
||
m_UpdateContextStack.Peek().DirtyFlags |= type;
|
||
return;
|
||
}
|
||
ApplyDirty(type);
|
||
}
|
||
|
||
private void ApplyDirty(TableDirtyType type)
|
||
{
|
||
m_DirtyFlag.Mark(type);
|
||
|
||
// 数据、布局或样式改变只使四叉树失效;仅多样式背景需要时再构建。
|
||
if ((type & (TableDirtyType.DataChanged | TableDirtyType.LayoutChanged | TableDirtyType.StyleChanged)) != 0)
|
||
m_QuadtreeDirty = true;
|
||
if ((type & (TableDirtyType.LayoutChanged | TableDirtyType.StyleChanged)) != 0)
|
||
m_StyleNamespaceDirty = true;
|
||
}
|
||
|
||
/// <summary>运行时样式变更回调:标记脏数据,下一帧重绘</summary>
|
||
private void OnPoolStyleChanged() => MarkDirty(TableDirtyType.StyleChanged);
|
||
|
||
[System.NonSerialized] private bool m_IsRefreshingFromScroll;
|
||
|
||
private void OnRectTransformDimensionsChange()
|
||
{
|
||
Vector2 layoutBaseSize = GetLayoutBaseSize();
|
||
if (layoutBaseSize != m_LastLayoutBaseSize)
|
||
{
|
||
m_LastLayoutBaseSize = layoutBaseSize;
|
||
MarkDirty(TableDirtyType.LayoutChanged);
|
||
}
|
||
}
|
||
|
||
private Vector2 GetLayoutBaseSize()
|
||
{
|
||
RectTransform baseTransform = m_ScrollRect != null && m_ScrollRect.viewport != null
|
||
? m_ScrollRect.viewport
|
||
: transform.parent as RectTransform;
|
||
if (baseTransform == null) baseTransform = rectTransform;
|
||
|
||
Vector2 size = baseTransform != null ? baseTransform.rect.size : Vector2.zero;
|
||
Vector2 selfSize = rectTransform != null ? rectTransform.rect.size : Vector2.zero;
|
||
return new Vector2(size.x > 0f ? size.x : (m_LastLayoutBaseSize.x > 0f ? m_LastLayoutBaseSize.x : selfSize.x),
|
||
size.y > 0f ? size.y : (m_LastLayoutBaseSize.y > 0f ? m_LastLayoutBaseSize.y : selfSize.y));
|
||
}
|
||
|
||
private void UpdateResolvedCellSizes()
|
||
{
|
||
Vector2 baseSize = GetLayoutBaseSize();
|
||
m_LastLayoutBaseSize = baseSize;
|
||
if (m_RowHeights == null || m_ColWidths == null)
|
||
{
|
||
m_ResolvedRowHeights = null;
|
||
m_ResolvedColWidths = null;
|
||
return;
|
||
}
|
||
|
||
if (m_ResolvedRowHeights == null || m_ResolvedRowHeights.Length != m_RowHeights.Length)
|
||
m_ResolvedRowHeights = new float[m_RowHeights.Length];
|
||
if (m_ResolvedColWidths == null || m_ResolvedColWidths.Length != m_ColWidths.Length)
|
||
m_ResolvedColWidths = new float[m_ColWidths.Length];
|
||
|
||
for (int i = 0; i < m_RowHeights.Length; i++)
|
||
m_ResolvedRowHeights[i] = XTableCoordinateUtility.ResolveSize(m_RowHeights[i], baseSize.y);
|
||
for (int i = 0; i < m_ColWidths.Length; i++)
|
||
m_ResolvedColWidths[i] = XTableCoordinateUtility.ResolveSize(m_ColWidths[i], baseSize.x);
|
||
}
|
||
|
||
private void OnScrollValueChanged(Vector2 _)
|
||
{
|
||
if (IsCheckingUpdate) return;
|
||
// 防重入:RefreshViewLight 中操作 content 可能触发 ScrollRect 再次回调
|
||
if (m_IsRefreshingFromScroll) return;
|
||
m_IsRefreshingFromScroll = true;
|
||
|
||
try
|
||
{
|
||
// 滚动时仅做轻刷新(RefreshViewLight 内部会调用 UpdateVisibleRect),
|
||
// 不重建背景、边框、不重置 content.sizeDelta、不做孤儿清理。
|
||
RefreshViewLight();
|
||
}
|
||
finally
|
||
{
|
||
m_IsRefreshingFromScroll = false;
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
}
|
||
}
|