如何避免Wagtail管理面板中的嵌套渲染问题？

你当前的代码中，NavBar的button字段使用了仅包含一个Field1Stream的StreamField，导致界面出现不必要的嵌套层级。以下是两种解决方法：

方法一：直接将字段移至StreamField（无需单独定义StreamBlock） #

如果不需要复用Field1Stream的结构，最简单的方式是把button1和button2直接作为NavBar的StreamField子块，去掉外层的Field1Stream嵌套：

class NavBar(ClusterableModel, PreviewableMixin):
    ...
    button = StreamField(
        [
            ("button1", AnotherBlock(label="button main")),
            ("button2", AnotherBlock(label="button secondary")),
        ],
        use_json_field=True,
        block_counts={
            "button1": {"max_num": 1},
            "button2": {"max_num": 1},
        },
        required=False
    )

这样既保留了原有的按钮数量限制、必填设置，又消除了不必要的嵌套层级。

方法二：用StructBlock替代StreamBlock（保留结构复用性） #

如果需要在其他地方复用这个按钮组结构，可以将Field1Stream改为StructBlock。StructBlock在Wagtail界面中是单一结构化块，不会生成嵌套层级：

from wagtail.core import blocks

class Field1Struct(blocks.StructBlock):
    button1 = AnotherBlock(label="button main")
    button2 = AnotherBlock(label="button secondary")

    class Meta:
        icon = "link"
        required = False
        template = "my_template.html"

class NavBar(ClusterableModel, PreviewableMixin):
    ...
    button = StreamField(
        [("field1", Field1Struct())],
        use_json_field=True,
        max_num=1
    )

StructBlock会将两个按钮字段整合在同一个块面板中展示，既保留了结构复用性，又避免了嵌套层级。

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