Files
XericUIActionVessel/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs
T
lrss3 51f5c5ecbb 表格:生成物解锁(只留 DontSave);新增「自动维护 ScrollRect 模板」开关
- 模板(Viewport/Content/滚动条)、背景、边框、冻结层的 hideFlags 去掉 NotEditable:
  不保存,但编辑器里可以改(换样式、调锚点都不会写进预制体)。
- 表组件新增 AutoScrollTemplate(Inspector「自动维护 ScrollRect 模板」,默认开):
  关掉后 EnsureScrollTemplate 直接返回——缺了不补、有也不重置,用户可以自己替换这几个节点;
  表格不会强制启用/禁用任何模板节点,它们是否有效由你摆。
- 调试开关(显示子项)随之只切 HideInHierarchy,不再动 NotEditable。
2026-11-17 16:21:05 +08:00

282 lines
13 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</c>(不保存、但编辑器里可改)。结构照右键菜单「生成表格」(<c>CreateTable</c>)那一套。
/// 表上的「自动维护 ScrollRect 模板」关掉后,这里整段不再碰它们。
///
/// <para><b>为什么整块都要管</b>(2026-11-13 现场):这几个节点以前是手摆进预制体的。
/// 保存预制体时它们把运行时的尺寸/布局一起存进去(尺寸被写歪);把表格组件从预制体里
/// 删掉之后,content 连同里面的渲染器还留在场景里。改成生成物之后:预制体里不再有它们的
/// 副本,组件销毁时由 <see cref="DestroyScrollTemplate"/> 一并收掉。</para>
/// </summary>
public partial class XericUIActionTable
{
/// <summary>模板生成物只标"不保存":编辑器里可以改(换样式/关节锚点),改动不会写进预制体。</summary>
private const HideFlags TemplateFlags = HideFlags.DontSave;
[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;
// 关掉自动维护:缺了不补、有也不重置(用户可以自己替换这几个节点)。
if (!m_AutoScrollTemplate) 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>
/// 图元渲染器(背景/边框)专用:它们的子块铺满本渲染器且轴心 0.5,顶点原点=rect 的<b>中心</b>。
/// 所以让这个 rect 的"中心"落在左上角(pivot 0.5 + 锚点 (0,1) + 锚位 0),
/// 绘图代码就能继续用左上角坐标,和文本(UGUI 左上角语义)对得上。
/// </summary>
private static void PinPrimitiveRect(RectTransform rt, Vector2 position, float width, float height)
{
if (rt == null) return;
Vector2 topLeft = new Vector2(0f, 1f);
Vector2 center = new Vector2(0.5f, 0.5f);
if (rt.anchorMin != topLeft) rt.anchorMin = topLeft;
if (rt.anchorMax != topLeft) rt.anchorMax = topLeft;
if (rt.pivot != center) rt.pivot = center;
if (rt.anchoredPosition != position) rt.anchoredPosition = position;
var size = new Vector2(width, height);
if (rt.sizeDelta != size) rt.sizeDelta = size;
}
/// <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);
}
}
}