Unity UI中如何避免自定义LayoutGroup的父GameObject塌陷为0尺寸？

问题描述 #

实现了一个自定义DummyLayout继承自LayoutGroup并实现ILayoutSelfController，挂载到子物体后，父物体添加ContentSizeFitter期望自适应子物体的1000x1000首选尺寸，但实际父物体尺寸塌陷为0x0。相关代码如下：

DummyLayout实现 #

public class DummyLayout : LayoutGroup, ILayoutSelfController
{
    protected override void OnEnable()
    {
        base.OnEnable();
        // Mark for layout rebuild when enabled to trigger parent ContentSizeFitter
        if (transform.parent != null)
        {
            var parentRect = transform.parent.GetComponent<RectTransform>();
            if (parentRect != null)
            {
                LayoutRebuilder.MarkLayoutForRebuild(parentRect);
            }
        }
    }

    public override void CalculateLayoutInputHorizontal()
    {
        // Calculate and cache horizontal layout properties for parent ContentSizeFitter to read
        SetLayoutInputForAxis(minWidth, preferredWidth, flexibleWidth, 0);
    }

    public override void CalculateLayoutInputVertical()
    {
        // Calculate and cache vertical layout properties for parent ContentSizeFitter to read
        SetLayoutInputForAxis(minHeight, preferredHeight, flexibleHeight, 1);
    }

    public override void SetLayoutHorizontal()
    {
        // This controls how this layout positions its children horizontally
        // Since it's a dummy layout, we don't need to do anything
    }

    public override void SetLayoutVertical()
    {
        // This controls how this layout positions its children vertically  
        // Since it's a dummy layout, we don't need to do anything
    }

    // Report current size as preferred size
    public override float minWidth => 500;
    public override float minHeight => 500;
    public override float preferredHeight => 1000;
    public override float preferredWidth => 1000;
    public override float flexibleWidth => -1;
    public override float flexibleHeight => -1;
    public override int layoutPriority => 1;
}

测试代码 #

public class DummyLayoutTest
{
    private GameObject testObject;
    private RectTransform rectTransform;
    private DummyLayout dummyLayout;

    [SetUp]
    public void SetUp()
    {
        // Create a Canvas for proper UI layout calculations
        var canvasObject = new GameObject("TestCanvas");
        var canvas = canvasObject.AddComponent<Canvas>();
        canvas.renderMode = RenderMode.ScreenSpaceOverlay;
        canvasObject.AddComponent<CanvasScaler>();
        canvasObject.AddComponent<GraphicRaycaster>();

        // Create test GameObject with RectTransform and add DummyLayout
        testObject = new GameObject("DummyLayoutTest");
        testObject.transform.SetParent(canvasObject.transform);

        rectTransform = testObject.AddComponent<RectTransform>();
        dummyLayout = testObject.AddComponent<DummyLayout>();
    }

    [TearDown]
    public void TearDown()
    {
        if (testObject != null)
        {
            Object.DestroyImmediate(testObject.transform.root.gameObject);
        }
    }

    [UnityTest]
    public IEnumerator DummyLayout_ParentContentSizeFitterResizesToChildPreferredSize()
    {
        // Create a parent object with ContentSizeFitter
        var parentObject = new GameObject("ParentWithSizeFitter");
        parentObject.transform.SetParent(testObject.transform.parent);
        var parentRectTransform = parentObject.AddComponent<RectTransform>();

        // Move testObject to be child of parent
        testObject.transform.SetParent(parentObject.transform);

        // Set initial size to something different for both parent and child
        parentRectTransform.sizeDelta = new Vector2(100f, 100f);
        rectTransform.sizeDelta = new Vector2(100f, 100f);

        // Add ContentSizeFitter to parent to control sizing based on child's layout
        var sizeFitter = parentObject.AddComponent<ContentSizeFitter>();
        sizeFitter.horizontalFit = ContentSizeFitter.FitMode.PreferredSize;
        sizeFitter.verticalFit = ContentSizeFitter.FitMode.PreferredSize;

        // Wait a few frames for layout system to update
        yield return null;
        yield return null;

        // Force layout rebuild to ensure layout system processes the changes
        LayoutRebuilder.ForceRebuildLayoutImmediate(parentRectTransform);

        yield return null;

        // Check that parent RectTransform size has been updated to child's preferred size
        Assert.AreEqual(1000f, parentRectTransform.sizeDelta.x, 0.1f,
            "Parent RectTransform width should be set to child's preferred width (1000), but it is " +
            parentRectTransform.sizeDelta.x);
        Assert.AreEqual(1000f, parentRectTransform.sizeDelta.y, 0.1f,
            "Parent RectTransform height should be set to child's preferred height (1000), but it is " +
            parentRectTransform.sizeDelta.y);
    }
}

原因分析 #

1. LayoutGroup子布局逻辑缺失：LayoutGroup的核心职责是计算并设置子物体布局，你的SetLayoutHorizontal和SetLayoutVertical为空实现，导致布局系统无法识别子物体的有效尺寸，父ContentSizeFitter无法获取正确的布局输入。
2. ILayoutSelfController重复实现冲突：LayoutGroup已间接实现ILayoutSelfController相关功能，重复实现会导致布局系统回调逻辑混乱。
3. 弹性尺寸设置错误：flexibleWidth和flexibleHeight设为-1，在Unity布局系统中表示不支持弹性扩展，会导致ContentSizeFitter无法正确计算尺寸。
4. 测试层级调整时机问题：先创建子物体再移动到父物体下，未及时触发布局重建，导致布局系统未捕获层级变化后的尺寸依赖。

修复方案 #

1. 修改DummyLayout实现 #

public class DummyLayout : LayoutGroup
{
    protected override void OnEnable()
    {
        base.OnEnable();
        // 标记自身需要重建布局，而非父物体
        LayoutRebuilder.MarkLayoutForRebuild(rectTransform);
    }

    public override void CalculateLayoutInputHorizontal()
    {
        base.CalculateLayoutInputHorizontal();
        // flexible设为0表示不弹性扩展，符合布局系统规范
        SetLayoutInputForAxis(minWidth, preferredWidth, 0, 0);
    }

    public override void CalculateLayoutInputVertical()
    {
        base.CalculateLayoutInputVertical();
        SetLayoutInputForAxis(minHeight, preferredHeight, 0, 1);
    }

    public override void SetLayoutHorizontal()
    {
        // 实现最基础的子物体布局逻辑，确保布局系统能识别子物体尺寸
        foreach (RectTransform child in rectChildren)
        {
            SetChildAlongAxis(child, 0, 0, rectTransform.rect.width);
        }
    }

    public override void SetLayoutVertical()
    {
        foreach (RectTransform child in rectChildren)
        {
            SetChildAlongAxis(child, 1, 0, rectTransform.rect.height);
        }
    }

    // 固定的最小和首选尺寸
    public override float minWidth => 500;
    public override float minHeight => 500;
    public override float preferredHeight => 1000;
    public override float preferredWidth => 1000;
    // flexible设为0，避免尺寸计算异常
    public override float flexibleWidth => 0;
    public override float flexibleHeight => 0;
    public override int layoutPriority => 1;
}

2. 调整测试代码 #

[UnityTest]
public IEnumerator DummyLayout_ParentContentSizeFitterResizesToChildPreferredSize()
{
    // Create a parent object with ContentSizeFitter
    var parentObject = new GameObject("ParentWithSizeFitter");
    parentObject.transform.SetParent(testObject.transform.parent);
    var parentRectTransform = parentObject.AddComponent<RectTransform>();
    // 设置父物体锚点为左上角，避免sizeDelta受拉伸影响
    parentRectTransform.anchorMin = Vector2.zero;
    parentRectTransform.anchorMax = Vector2.zero;
    parentRectTransform.pivot = Vector2.zero;

    // Move testObject to be child of parent
    testObject.transform.SetParent(parentObject.transform);
    // 设置子物体锚点为拉伸，确保填充父物体
    rectTransform.anchorMin = Vector2.zero;
    rectTransform.anchorMax = Vector2.one;
    rectTransform.sizeDelta = Vector2.zero;

    // Add ContentSizeFitter to parent to control sizing based on child's layout
    var sizeFitter = parentObject.AddComponent<ContentSizeFitter>();
    sizeFitter.horizontalFit = ContentSizeFitter.FitMode.PreferredSize;
    sizeFitter.verticalFit = ContentSizeFitter.FitMode.PreferredSize;

    // 立即触发布局重建，确保层级变化后布局系统正确计算尺寸
    LayoutRebuilder.ForceRebuildLayoutImmediate(parentRectTransform);
    yield return null;

    // Check that parent RectTransform size has been updated to child's preferred size
    Assert.AreEqual(1000f, parentRectTransform.sizeDelta.x, 0.1f,
        "Parent RectTransform width should be set to child's preferred width (1000), but it is " +
        parentRectTransform.sizeDelta.x);
    Assert.AreEqual(1000f, parentRectTransform.sizeDelta.y, 0.1f,
        "Parent RectTransform height should be set to child's preferred height (1000), but it is " +
        parentRectTransform.sizeDelta.y);
}

关键修复点说明 #

• 移除ILayoutSelfController接口，避免与LayoutGroup内置实现冲突。
• 在SetLayout系列方法中实现基础子布局逻辑，确保布局系统能识别子物体尺寸。
• 将flexible系列属性改为0，符合Unity布局系统参数规范。
• 测试中调整锚点设置，避免sizeDelta计算受锚点拉伸影响。
• 及时触发布局重建，确保层级变化后布局系统正确计算尺寸。

内容的提问来源于stack exchange，提问作者tribbloid