Files
XericUIActionVessel/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs
T
lrss3 048ec7d116 表格:初始化改逐项对齐(有则复用、无则新建);背景原点按 rect 实际尺寸换算
- Awake 与三个重建入口不再"先清空再重建",改走 ReconcileGeneratedHierarchy:模板、背景、
  边框、冻结层逐项检查,存在就复用(各自重置 rect 与内容),缺了才建。编辑模式下预制体实例
  里的对象本来就不能 DestroyImmediate,这条路径也顺手绕开了它。
- 池的四个显隐回调与 ReleaseAllTrackedCells 跳过已销毁的根:手工删过生成物之后,
  ReturnCounter 会把已销毁对象交给 SetActive,抛 MissingReferenceException。
- XTableBackgroundRenderer 的图元坐标按 rectTransform.rect 换算:本地原点是轴心、图元坐标是
  左上角原点,以前只在 pivot=(0,1) 时重合;现在轴心是什么都对,不再依赖调用方先摆好 pivot。
2026-11-17 15:17:40 +08:00

261 lines
12 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 UnityEngine;
using UnityEngine.UI;
using XericUI.Core;
namespace XericUI.XTable.Rendering.Component
{
/// <summary>
/// ScrollRect 模板:Viewport / Content / 横竖滚动条全部由表格自己生成,统一标记
/// <c>DontSave | NotEditable</c>。结构照右键菜单「生成表格」(<c>CreateTable</c>)那一套。
///
/// <para><b>为什么整块都要管</b>(2026-11-13 现场):这几个节点以前是手摆进预制体的。
/// 保存预制体时它们把运行时的尺寸/布局一起存进去(尺寸被写歪);把表格组件从预制体里
/// 删掉之后,content 连同里面的渲染器还留在场景里。改成生成物之后:预制体里不再有它们的
/// 副本,组件销毁时由 <see cref="DestroyScrollTemplate"/> 一并收掉。</para>
/// </summary>
public partial class XericUIActionTable
{
/// <summary>模板生成物的统一标记:不保存、不进编辑。</summary>
private const HideFlags TemplateFlags = HideFlags.DontSave | HideFlags.NotEditable;
[NonSerialized] private RectTransform m_TemplateViewport;
[NonSerialized] private RectTransform m_TemplateContent;
[NonSerialized] private Scrollbar m_TemplateHBar;
[NonSerialized] private Scrollbar m_TemplateVBar;
/// <summary>内容区左上角是否已按尺寸钉过一次;补齐模板/重建时清零,让下一次刷新重新钉。</summary>
[NonSerialized] private bool m_ContentPinned;
/// <summary>
/// 补齐 ScrollRect 模板。缺什么补什么;手摆的旧节点按名字认领后就地改成生成物
/// (下一次保存预制体时它们会从文件里消失,之后每次加载由这里重建)。
/// </summary>
[ContextMenu(XericRegistrationPaths.Table + "/补齐 ScrollRect 骨架")]
public void EnsureScrollTemplate()
{
if (m_ScrollRect == null) return;
var self = rectTransform;
if (self == null) return;
RectTransform viewport = EnsureViewport(self);
RectTransform content = EnsureContent(viewport);
Scrollbar hBar = EnsureScrollbar(self, true);
Scrollbar vBar = EnsureScrollbar(self, false);
if (m_ScrollRect.viewport != viewport) m_ScrollRect.viewport = viewport;
if (m_ScrollRect.content != content) m_ScrollRect.content = content;
if (m_ScrollRect.horizontalScrollbar != hBar) m_ScrollRect.horizontalScrollbar = hBar;
if (m_ScrollRect.verticalScrollbar != vBar) m_ScrollRect.verticalScrollbar = vBar;
m_ScrollRect.horizontalScrollbarVisibility = ScrollRect.ScrollbarVisibility.AutoHide;
m_ScrollRect.verticalScrollbarVisibility = ScrollRect.ScrollbarVisibility.AutoHide;
m_ScrollRect.movementType = ScrollRect.MovementType.Clamped;
m_TemplateViewport = viewport;
m_TemplateContent = content;
m_TemplateHBar = hBar;
m_TemplateVBar = vBar;
// 下一次 RefreshView 把左上角按尺寸重新钉一次(生成的内容先小后大,ScrollRect 会夹走位置)。
m_ContentPinned = false;
}
/// <summary>
/// 逐项对齐生成物:<b>存在就复用</b>(各自会重置 rect 与内容),不存在才创建。
///
/// <para>替代"先清空再重建":编辑模式下预制体实例里的对象不能 DestroyImmediate,
/// 手工删过之后池里还会留下已销毁的引用(MissingReferenceException)。逐项对齐不会
/// 碰任何不该碰的东西,重复调用也是幂等的。</para>
/// </summary>
private void ReconcileGeneratedHierarchy()
{
EnsureScrollTemplate();
CreateBackground();
GetOrCreateBorderRenderer();
CreateViewportRenderer();
}
/// <summary>销毁模板(组件被销毁时调用;只收自己生成的这一份)。</summary>
private void DestroyScrollTemplate()
{
m_TemplateContent = null;
DestroyGenerated(m_TemplateViewport);
m_TemplateViewport = null;
DestroyGenerated(m_TemplateHBar != null ? m_TemplateHBar.gameObject : null);
m_TemplateHBar = null;
DestroyGenerated(m_TemplateVBar != null ? m_TemplateVBar.gameObject : null);
m_TemplateVBar = null;
if (m_ScrollRect != null)
{
m_ScrollRect.content = null;
m_ScrollRect.viewport = null;
m_ScrollRect.horizontalScrollbar = null;
m_ScrollRect.verticalScrollbar = null;
}
}
private RectTransform EnsureViewport(Transform self)
{
RectTransform vrt = m_ScrollRect.viewport;
if (vrt == null)
{
Transform found = self.Find("Viewport");
if (found != null) vrt = found as RectTransform;
}
if (vrt == null)
{
var go = new GameObject("Viewport", typeof(RectTransform), typeof(Image), typeof(Mask));
vrt = go.GetComponent<RectTransform>();
vrt.SetParent(self, false);
go.GetComponent<Image>().color = new Color(1f, 1f, 1f, 0.01f);
Debug.Log("[XTable] 补 Viewport:" + name);
}
vrt.anchorMin = Vector2.zero;
vrt.anchorMax = Vector2.one;
vrt.offsetMin = Vector2.zero;
vrt.offsetMax = Vector2.zero;
MarkGenerated(vrt.gameObject);
return vrt;
}
private RectTransform EnsureContent(RectTransform viewport)
{
RectTransform crt = m_ScrollRect.content as RectTransform;
if (crt == null)
{
Transform found = viewport != null ? viewport.Find("Content") : transform.Find("Content");
if (found != null) crt = found as RectTransform;
}
if (crt == null)
{
var go = new GameObject("Content", typeof(RectTransform));
crt = go.GetComponent<RectTransform>();
crt.SetParent(viewport != null ? (Transform)viewport : transform, false);
crt.sizeDelta = new Vector2(800f, 600f);
Debug.Log("[XTable] 补 Content:" + name);
}
crt.anchorMin = new Vector2(0f, 1f);
crt.anchorMax = new Vector2(0f, 1f);
crt.pivot = new Vector2(0f, 1f);
crt.anchoredPosition = Vector2.zero;
MarkGenerated(crt.gameObject);
return crt;
}
private Scrollbar EnsureScrollbar(Transform self, bool horizontal)
{
string barName = horizontal ? "Scrollbar Horizontal" : "Scrollbar Vertical";
Scrollbar bar = horizontal ? m_ScrollRect.horizontalScrollbar : m_ScrollRect.verticalScrollbar;
if (bar == null)
{
Transform found = self.Find(barName);
if (found != null) bar = found.GetComponent<Scrollbar>();
}
if (bar == null)
{
var go = new GameObject(barName, typeof(RectTransform), typeof(Scrollbar), typeof(Image));
bar = go.GetComponent<Scrollbar>();
go.GetComponent<Image>().color = new Color(0.15f, 0.15f, 0.15f, 0.5f);
var sliding = new GameObject("Sliding Area", typeof(RectTransform));
sliding.transform.SetParent(go.transform, false);
var handle = new GameObject("Handle", typeof(RectTransform), typeof(Image));
handle.transform.SetParent(sliding.transform, false);
handle.GetComponent<Image>().color = new Color(0.4f, 0.4f, 0.4f, 0.8f);
RectTransform slidingRt = (RectTransform)sliding.transform;
slidingRt.anchorMin = Vector2.zero;
slidingRt.anchorMax = Vector2.one;
slidingRt.sizeDelta = horizontal ? new Vector2(-20f, 0f) : new Vector2(0f, -20f);
RectTransform handleRt = (RectTransform)handle.transform;
handleRt.anchorMin = Vector2.zero;
handleRt.anchorMax = Vector2.one;
handleRt.sizeDelta = new Vector2(-10f, -10f);
bar.handleRect = handleRt;
bar.transform.SetParent(self, false);
Debug.Log("[XTable] 补 " + barName + ":" + name);
}
RectTransform rt = (RectTransform)bar.transform;
if (horizontal)
{
rt.anchorMin = new Vector2(0f, 0f);
rt.anchorMax = new Vector2(1f, 0f);
rt.pivot = new Vector2(0.5f, 0f);
rt.anchoredPosition = new Vector2(0f, 4f);
rt.sizeDelta = new Vector2(-16f, 20f);
bar.direction = Scrollbar.Direction.LeftToRight;
}
else
{
rt.anchorMin = new Vector2(1f, 0f);
rt.anchorMax = new Vector2(1f, 1f);
rt.pivot = new Vector2(1f, 0.5f);
rt.anchoredPosition = new Vector2(-4f, 0f);
rt.sizeDelta = new Vector2(20f, -16f);
bar.direction = Scrollbar.Direction.BottomToTop;
}
MarkGenerated(bar.gameObject);
return bar;
}
/// <summary>
/// 把生成物的 rect 钉成"锚点左上 + 指定锚位",只在值不同的时候写。
///
/// <para>生成物可能是域重载后认领回来的旧对象(<c>_TableBackground</c> / <c>_TableBorders</c>),
/// 它们的锚点/锚位还是上一版留下的——只改 sizeDelta 就会画出"以父组件中心为左上角"的错位。</para>
/// </summary>
private static void PinTopLeftRect(RectTransform rt, Vector2 position)
{
if (rt == null) return;
Vector2 topLeft = new Vector2(0f, 1f);
if (rt.anchorMin != topLeft) rt.anchorMin = topLeft;
if (rt.anchorMax != topLeft) rt.anchorMax = topLeft;
if (rt.pivot != topLeft) rt.pivot = topLeft;
if (rt.anchoredPosition != position) rt.anchoredPosition = position;
}
/// <summary>同上,顺带把尺寸一起钉死。</summary>
private static void PinTopLeftRect(RectTransform rt, Vector2 position, float width, float height)
{
if (rt == null) return;
PinTopLeftRect(rt, position);
var size = new Vector2(width, height);
if (rt.sizeDelta != size) rt.sizeDelta = size;
}
/// <summary>把生成物及其子物体统一标记为不保存、不进编辑。</summary>
private static void MarkGenerated(GameObject go)
{
if (go == null) return;
go.hideFlags = TemplateFlags;
Transform t = go.transform;
for (int i = 0; i < t.childCount; i++)
MarkGenerated(t.GetChild(i).gameObject);
}
private static void DestroyGenerated(UnityEngine.Object target)
{
if (target == null) return;
#if UNITY_EDITOR
// 预制体实例里的对象不许立即销毁(同 Awake 那个坑);它们本来就不保存,重载后自然不在。
if (!Application.isPlaying && UnityEditor.PrefabUtility.IsPartOfPrefabInstance(target))
return;
if (!Application.isPlaying)
{
UnityEngine.Object.DestroyImmediate(target);
return;
}
#endif
UnityEngine.Object.Destroy(target);
}
}
}