Wagtail新建Page时如何为StreamField设置默认块

可以实现，Wagtail的StreamField支持通过default参数配置预设默认块，无论简单块还是嵌套的复杂结构块都可适配，具体实现方式如下：

1. 简单TextBlock默认配置 #

针对你给出的单TextBlock场景，直接给StreamField传入default参数即可，参数为列表结构，每个元素对应一个默认块，格式为(块类型名, 块内容)：

class CustomPage(Page):
    body = StreamField(
        [("text", TextBlock())],
        # 配置默认带一个填充好默认文本的text块
        default=[("text", "这是预设的默认文本内容")]
    )

配置完成后新建CustomPage页面时，body字段会自动加载该预设块。

2. 嵌套复杂块默认配置 #

针对ItemList这类嵌套的StructBlock、StreamBlock结构，只需按照块的层级对应配置内容即可：

• StructBlock的内容用字典格式，key对应块内的字段名
• StreamBlock的内容用列表格式，每个元素同样遵循(块类型名, 块内容)规则

完整示例代码如下：

from wagtail.fields import StreamField
from wagtail.blocks import TextBlock, CharBlock, ImageChooserBlock, StructBlock, StreamBlock
from wagtail.models import Page

class Item(StructBlock):
    text = CharBlock()
    image = ImageChooserBlock()

class ItemList(StructBlock):
    items = StreamBlock([("item", Item()),])

class CustomPage(Page):
    body = StreamField(
        [
            ("text", TextBlock()),
            ("item_list", ItemList())
        ],
        # 配置默认带一个ItemList块，内含2个预设的Item条目
        default=[
            ("item_list", {
                "items": [
                    ("item", {
                        "text": "默认条目1文本",
                        "image": None  # 若需预设图片，替换为对应图片的ID即可，例如 image=10
                    }),
                    ("item", {
                        "text": "默认条目2文本",
                        "image": None
                    })
                ]
            })
        ]
    )

注意事项 #

• default参数的配置仅对新增页面生效，不会修改已创建的历史页面数据
• 如果需要同时预设多个不同类型的默认块，在最外层的default列表中依次添加对应(块类型, 内容)元组即可

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