Files
XericUIActionVessel/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs
T
lrss3 acae50f713 表格:背景/边框的图元原点按"rect 中心"摆放;调试开关覆盖整棵生成层级
坐标错位的真正来源在图元渲染器的上游:PrimitiveCacheRendererBase / CacheLineRendererBase 把
子块建成"铺满本渲染器、轴心 0.5"的对象,顶点直接放在子块本地空间 ⇒ 图元坐标的原点是
rect 的<b>中心</b>,不是左上角。表格喂的是左上角坐标,于是背景与边框(两者都是图元渲染器)
一起偏了半个尺寸、彼此严丝合缝,却和文本(UGUI 左上角语义)对不上。

- 新增 PinPrimitiveRect:锚点 (0,1)、轴心 0.5、锚位放在左上角 ⇒ rect 中心(即网格原点)
  与左上角重合;背景、边框、冻结边框都改走它,绘图代码保持左上角语义不变。
- 撤回上一版按 rectTransform.rect 换算原点的做法(那个假设是错的)。
- SetChildrenVisible 改为遍历整棵生成层级(模板/背景/边框/冻结层/池化单元格),
  显示时只去掉 HideInHierarchy、保留 NotEditable:调试视图能看到每一个生成物。
2026-11-17 15:32:18 +08:00

279 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 | 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>
/// 图元渲染器(背景/边框)专用:它们的子块铺满本渲染器且轴心 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);
}
}
}