Wagtail中嵌套于StreamField的StreamBlock拆分功能可行性问询

我想确认当前Wagtail是否支持该功能，还是需要添加表单小部件适配器来实现。

我的页面模型中有一个StreamField，定义如下：

body = StreamField(
    [
        ("introduction", content_blocks.IntroductionBlock()),
        ("benefits", content_blocks.BenefitsBlock()),
        ("alternatives", content_blocks.AlternativesBlock()),
        ("detail", content_blocks.DetailBlock()),
        ("success", content_blocks.SuccessBlock()),
        ("complications", content_blocks.ComplicationsBlock()),
        ("medication", content_blocks.MedicationBlock()),
        ("recovery", content_blocks.RecoveryBlock()),
        ("summary", content_blocks.SummaryBlock()),
    ],
    use_json_field=True,
)

每个区块的定义如下：

class PanelBlock(blocks.StreamBlock):
    header = HeaderBlock()
    content = BaseContentBlock()
    snippet = ReusableSnippetBlock()
    choice = LibraryChoiceBlock()
    embed = VideoBlock()
    figure = FigureBlock()


class IntroductionBlock(PanelBlock):
    class Meta:
        icon = "help"
        label = _("Introduction")
        label_format = "Introduction"


class BenefitsBlock(PanelBlock):
    class Meta:
        icon = "circle-check"
        label = _("Benefits")
        label_format = "Benefits"

# 其他类似区块...

我的模板逻辑通过这些PanelBlock将内容分割为div，编辑人员常希望这些div的长度大致相近，以保证用户端视觉平衡（避免某个面板远长于或短于其他面板）。

检查面板平衡时，若某个区块远长于其他同级区块，编辑人员希望能通过操作菜单在指定位置拆分该StreamBlock（就像嵌套在StreamBlock中的RichTextBlock支持的拆分功能一样），但即使父级是StreamField，StreamBlock仍缺少“拆分”操作。

查看Wagtail代码库后，我认为该功能似乎已存在（可能理解有误），因此我的问题是：
该功能是否已存在，只是我的实现存在问题导致拆分/操作菜单被错误禁用？还是需要定制解决方案？

目前我已查阅Wagtail文档、代码库及相关GitHub问题，试图了解现有“拆分”功能的支持范围，以及是否可轻松扩展组合框。

核心结论 #

Wagtail默认不支持直接拆分嵌套的StreamBlock实例，你看不到操作菜单不是实现错误，而是该功能不在内置支持范围内——你看到的StreamBlock.js中的代码是针对区块内部子块的操作逻辑，并非针对整个StreamBlock作为父级区块的拆分功能。

原因说明 #

Wagtail的内置拆分功能仅针对内联可编辑的原子块（比如RichTextBlock、CharBlock这类）：这类块可以通过光标定位具体位置，将内容拆分为两个独立块。而StreamBlock是复合容器块，由多个子块组成，Wagtail没有默认提供对整个容器块的拆分逻辑，因此不会显示拆分操作菜单。

定制解决方案思路 #

如果你需要这个拆分功能，需要通过自定义扩展实现，以下是可行方向：

• 自定义块操作菜单：给PanelBlock添加拆分按钮。需要编写JavaScript扩展，监听按钮点击事件，将当前StreamBlock的子块列表拆分为两部分，创建两个同类型的新PanelBlock实例，替换原来的单个区块。你可以通过在PanelBlock的Meta类中指定js属性，引入自定义JS文件来扩展Wagtail的BlockActionMenu组件。
• 调整页面模型设计：如果允许同一类型的PanelBlock重复出现，可以修改body StreamField的定义，将每个PanelBlock子类设置为可重复添加（去掉原来的唯一键限制），让编辑人员直接添加多个同类型区块来替代拆分操作——不过这需要结合你的业务场景判断是否适用。
• 第三方工具辅助：可以查看wagtail-streamfield-tools等第三方包是否提供类似功能，但自定义扩展的灵活性和可靠性更高。

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