From 9efd0aebd98b0c8a13b4df32225b57973c5e6383 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Sat, 14 Nov 2026 10:28:05 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A8=E6=A0=BC=EF=BC=9AScrollRect=20?= =?UTF-8?q?=E6=A8=A1=E6=9D=BF=EF=BC=88Viewport/Content/=E6=BB=9A=E5=8A=A8?= =?UTF-8?q?=E6=9D=A1=EF=BC=89=E6=94=B9=E6=88=90=E7=94=9F=E6=88=90=E7=89=A9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 结构照右键菜单「生成表格」:Viewport(RectTransform+Image+Mask) → Content(anchor/pivot 0,1) → 横/竖滚动条(Sliding Area + Handle)→ 接线(AutoHide + Clamped)。区别是全部节点标 DontSave | NotEditable: - 预制体里不再存它们的副本,保存时不会把运行时的尺寸/布局一起存进去; - 组件删掉时 OnDestroy 调 DestroyScrollTemplate 一并收掉,content 不会带着渲染器留在场景里; - 旧的手摆节点按名字认领后就地改成生成物,下一次保存预制体时从文件里消失。 Awake 与三个重建入口(FullRebuild / FullRebuildPreservingData / ClearTable)都先补齐模板 再清空子物体。 --- .../Component/XericUIActionTable.Api.cs | 6 +- .../XericUIActionTable.ScrollTemplate.cs | 214 ++++++++++++++++++ .../XericUIActionTable.ScrollTemplate.cs.meta | 11 + .../Rendering/Component/XericUIActionTable.cs | 85 +------ 4 files changed, 233 insertions(+), 83 deletions(-) create mode 100644 Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs create mode 100644 Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs.meta diff --git a/Runtime/XTable/Rendering/Component/XericUIActionTable.Api.cs b/Runtime/XTable/Rendering/Component/XericUIActionTable.Api.cs index 27d5be5..869e9a0 100644 --- a/Runtime/XTable/Rendering/Component/XericUIActionTable.Api.cs +++ b/Runtime/XTable/Rendering/Component/XericUIActionTable.Api.cs @@ -662,7 +662,7 @@ namespace XericUI.XTable.Rendering.Component m_Assembler?.DestroyAll(); m_PrefabPool?.DestroyAll(); - EnsureScrollStructure(); + EnsureScrollTemplate(); ClearAllChildren(); m_BackgroundRenderer = null; m_BorderRenderer = null; @@ -723,7 +723,7 @@ namespace XericUI.XTable.Rendering.Component m_Assembler?.DestroyAll(); m_PrefabPool?.DestroyAll(); - EnsureScrollStructure(); + EnsureScrollTemplate(); ClearAllChildren(); m_BackgroundRenderer = null; m_BorderRenderer = null; @@ -811,7 +811,7 @@ namespace XericUI.XTable.Rendering.Component m_Assembler?.DestroyAll(); m_PrefabPool?.DestroyAll(); - EnsureScrollStructure(); + EnsureScrollTemplate(); ClearAllChildren(); m_BackgroundRenderer = null; m_BorderRenderer = null; diff --git a/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs b/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs new file mode 100644 index 0000000..e6c85da --- /dev/null +++ b/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs @@ -0,0 +1,214 @@ +using System; +using UnityEngine; +using UnityEngine.UI; +using XericUI.Core; + +namespace XericUI.XTable.Rendering.Component +{ + /// + /// ScrollRect 模板:Viewport / Content / 横竖滚动条全部由表格自己生成,统一标记 + /// DontSave | NotEditable。结构照右键菜单「生成表格」(CreateTable)那一套。 + /// + /// 为什么整块都要管(2026-11-13 现场):这几个节点以前是手摆进预制体的。 + /// 保存预制体时它们把运行时的尺寸/布局一起存进去(尺寸被写歪);把表格组件从预制体里 + /// 删掉之后,content 连同里面的渲染器还留在场景里。改成生成物之后:预制体里不再有它们的 + /// 副本,组件销毁时由 一并收掉。 + /// + public partial class XericUIActionTable + { + /// 模板生成物的统一标记:不保存、不进编辑。 + 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; + + /// + /// 补齐 ScrollRect 模板。缺什么补什么;手摆的旧节点按名字认领后就地改成生成物 + /// (下一次保存预制体时它们会从文件里消失,之后每次加载由这里重建)。 + /// + [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; + } + + /// 销毁模板(组件被销毁时调用;只收自己生成的这一份)。 + 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(); + vrt.SetParent(self, false); + go.GetComponent().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(); + 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(); + } + + if (bar == null) + { + var go = new GameObject(barName, typeof(RectTransform), typeof(Scrollbar), typeof(Image)); + bar = go.GetComponent(); + go.GetComponent().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().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; + } + + /// 把生成物及其子物体统一标记为不保存、不进编辑。 + 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); + } + } +} diff --git a/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs.meta b/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs.meta new file mode 100644 index 0000000..8d6ce90 --- /dev/null +++ b/Runtime/XTable/Rendering/Component/XericUIActionTable.ScrollTemplate.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: bf00467a8a0e4a398c67f80b4b343e42 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Runtime/XTable/Rendering/Component/XericUIActionTable.cs b/Runtime/XTable/Rendering/Component/XericUIActionTable.cs index 3b66e82..12ef954 100644 --- a/Runtime/XTable/Rendering/Component/XericUIActionTable.cs +++ b/Runtime/XTable/Rendering/Component/XericUIActionTable.cs @@ -212,85 +212,6 @@ namespace XericUI.XTable.Rendering.Component } } - /// - /// 补齐 ScrollRect 的骨架(Viewport + Content)。 - /// - /// 为什么要在重建之前补(2026-11-13 现场):ScrollRect 还在、但它的 - /// content/viewport 引用空了的时候, 会回落到表自己的 - /// rectTransform ⇒ ① 表格把自己的尺寸写成内容尺寸(预制体一保存就是那个"奇怪的尺寸"); - /// ② 重建时的清空清的是表自己的子物体,把原来的 Viewport/Content 一起清掉,越修越空。 - /// 骨架回来了,这两件事都不会再发生。 - /// - /// 只补缺的那一段;按名字找得到就认领它(手摆的 Viewport/Content 不会被换成新的)。 - /// - [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() == null && viewportT.GetComponent() == null) - viewportT.gameObject.AddComponent(); - - 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 - } - /// 表格全局配置资源 public XTableConfig Config { @@ -355,7 +276,7 @@ namespace XericUI.XTable.Rendering.Component // ScrollRect 的 content/viewport 丢了就先补骨架:否则下面的清空会把表自己的子物体 // 当成残留清掉(越重建越空),尺寸也会写到表自己身上。 - EnsureScrollStructure(); + EnsureScrollTemplate(); // 域重载后旧子对象可能残留在场景中(DontSave 不自动销毁),先清空再重建 ClearAllChildren(); @@ -447,6 +368,10 @@ namespace XericUI.XTable.Rendering.Component DestroyFrozenRenderers(); DestroySelectionOverlay(ref m_NormalSelectionOverlay); + // ScrollRect 模板是我们生成的:组件删掉时连同 Viewport/Content/滚动条一起收掉, + // 否则 content 会带着里面的渲染器留在场景里(2026-11-13 现场)。 + DestroyScrollTemplate(); + base.OnDestroy(); }