Files
XericUIActionVessel/Runtime/XTable/Rendering/Component/XericUIActionTable.cs
T
lrss3 d861ea60fc 表格:Awake 不再死循环;预制体实例里不清子物体;重建前补齐 ScrollRect 骨架
- Play 下 Destroy 是延迟销毁,while (childCount > 0) 同帧永远不减少 ⇒ Awake 出不来。
  改成倒序 for + Destroy;编辑模式仍用 DestroyImmediate。
- 预制体实例里的子物体归预制体所有,编辑模式 DestroyImmediate 会抛异常(Awake 与每帧的
  孤立清理都会撞)。两处都跳过实例内子物体;后者逐个子物体判归属,且不写 hideFlags。
- ScrollRect 的 content/viewport 为空时 ContentTransform 回落到表自己:内容尺寸被写给表本身
  (保存预制体就是那个"奇怪尺寸"),清空还会把表自己的子物体一起清掉。新增
  EnsureScrollStructure():补齐 Viewport(RectMask2D)/Content,按名字认领、不重复建;
  接在 Awake 与 FullRebuild/FullRebuildPreservingData/ClearTable 之前,另加右键菜单。
2026-11-13 15:19:45 +08:00

590 lines
23 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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>
/// 补齐 ScrollRect 的骨架(Viewport + Content)。
///
/// <para><b>为什么要在重建之前补</b>(2026-11-13 现场):ScrollRect 还在、但它的
/// content/viewport 引用空了的时候,<see cref="ContentTransform"/> 会回落到表自己的
/// rectTransform ⇒ ① 表格把自己的尺寸写成内容尺寸(预制体一保存就是那个"奇怪的尺寸");
/// ② 重建时的清空清的是表自己的子物体,把原来的 Viewport/Content 一起清掉,越修越空。
/// 骨架回来了,这两件事都不会再发生。</para>
///
/// <para>只补缺的那一段;按名字找得到就认领它(手摆的 Viewport/Content 不会被换成新的)。</para>
/// </summary>
[ContextMenu(XericRegistrationPaths.Table + "/补齐 ScrollRect 骨架")]
public void EnsureScrollStructure()
{
if (m_ScrollRect == null) return;
var self = rectTransform;
if (self == null) return;
bool changed = false;
if (m_ScrollRect.viewport == null)
{
Transform viewportT = self.Find("Viewport");
if (viewportT == null)
{
viewportT = new GameObject("Viewport", typeof(RectTransform)).transform;
viewportT.SetParent(self, false);
}
var vrt = viewportT as RectTransform;
if (vrt != null)
{
vrt.anchorMin = Vector2.zero;
vrt.anchorMax = Vector2.one;
vrt.offsetMin = Vector2.zero;
vrt.offsetMax = Vector2.zero;
}
if (viewportT.GetComponent<RectMask2D>() == null && viewportT.GetComponent<Mask>() == null)
viewportT.gameObject.AddComponent<RectMask2D>();
m_ScrollRect.viewport = vrt;
changed = true;
Debug.Log("[XTable] ScrollRect 缺 Viewport,已补齐:" + name);
}
if (m_ScrollRect.content == null)
{
Transform parent = m_ScrollRect.viewport != null ? (Transform)m_ScrollRect.viewport : self;
Transform contentT = parent.Find("Content");
if (contentT == null && parent != self)
contentT = self.Find("Content");
if (contentT == null)
{
contentT = new GameObject("Content", typeof(RectTransform)).transform;
contentT.SetParent(parent, false);
}
var crt = contentT as RectTransform;
if (crt != null)
{
crt.anchorMin = new Vector2(0f, 1f);
crt.anchorMax = new Vector2(0f, 1f);
crt.pivot = new Vector2(0f, 1f);
crt.anchoredPosition = Vector2.zero;
crt.sizeDelta = Vector2.zero;
}
m_ScrollRect.content = crt;
changed = true;
Debug.Log("[XTable] ScrollRect 缺 Content,已补齐:" + name);
}
#if UNITY_EDITOR
if (changed && !Application.isPlaying)
EditorUtility.SetDirty(m_ScrollRect);
#endif
}
/// <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 的 content/viewport 丢了就先补骨架:否则下面的清空会把表自己的子物体
// 当成残留清掉(越重建越空),尺寸也会写到表自己身上。
EnsureScrollStructure();
// 域重载后旧子对象可能残留在场景中(DontSave 不自动销毁),先清空再重建
ClearAllChildren();
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);
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
}
}