Wagtail框架构建轮播模型：类ChoiceBlock选型及子块限制方案问询

嘿，刚好我在Wagtail里做过类似的轮播需求，给你分享两个核心问题的解决方案：

1. 实现「图片/视频二选一」的幻灯片结构 #

你说的类似ChoiceBlock兼容其他块类型的需求，其实不用纠结StreamBlock，用StructBlock+ConditionalPanel就能完美实现——把单张幻灯片做成一个独立的结构化块，让用户先选媒体类型，再只显示对应的上传控件，同时通过校验确保不会同时上传两种媒体。

直接上代码示例：

from wagtail.blocks import StructBlock, ChoiceBlock, ImageChooserBlock, VideoChooserBlock, RichTextBlock
from wagtail.admin.panels import FieldPanel, ConditionalPanel
from django.core.exceptions import ValidationError

class SlideBlock(StructBlock):
    # 先让用户选媒体类型
    media_type = ChoiceBlock(
        choices=[
            ('image', '图片'),
            ('video', '视频'),
        ],
        label='媒体类型',
        required=True
    )
    # 图片和视频都设为非必填，靠后续校验控制
    image = ImageChooserBlock(required=False)
    video = VideoChooserBlock(required=False)
    # 描述字段
    description = RichTextBlock(label='幻灯片描述')

    class Meta:
        label = '单张幻灯片'
        template = 'blocks/slide_block.html'  # 你自己的渲染模板
        # 后台编辑面板：只显示选中媒体类型的控件
        panels = [
            FieldPanel('media_type'),
            ConditionalPanel(
                FieldPanel('image'),
                condition=lambda form: form.cleaned_data.get('media_type') == 'image'
            ),
            ConditionalPanel(
                FieldPanel('video'),
                condition=lambda form: form.cleaned_data.get('media_type') == 'video'
            ),
            FieldPanel('description'),
        ]

    # 数据校验：确保媒体类型和上传内容匹配，且不同时存在
    def clean(self, value):
        cleaned_data = super().clean(value)
        media_type = cleaned_data.get('media_type')
        image = cleaned_data.get('image')
        video = cleaned_data.get('video')

        if media_type == 'image' and not image:
            raise ValidationError("选了图片类型，请上传对应的图片")
        if media_type == 'video' and not video:
            raise ValidationError("选了视频类型，请上传对应的视频")
        if image and video:
            raise ValidationError("每张幻灯片只能选图片或视频中的一种，请勿同时上传")
        
        return cleaned_data

2. 限制轮播的幻灯片数量 #

把上面的SlideBlock放到ListBlock里，利用ListBlock自带的min_num和max_num参数就能轻松限制轮播的幻灯片数量：

from wagtail.models import Page
from wagtail.fields import StreamField

class CarouselPage(Page):
    # 用StreamField嵌套ListBlock，保证编辑体验的灵活性
    carousel = StreamField(
        [
            ('slide', SlideBlock()),
        ],
        min_num=1,  # 至少1张幻灯片
        max_num=8,  # 最多8张，按需调整
        use_json_field=True,
        blank=False,
        label='轮播幻灯片'
    )

    content_panels = Page.content_panels + [
        FieldPanel('carousel'),
    ]

为什么不用StreamBlock？ #

StreamBlock的设计是允许插入任意顺序、任意数量的不同块类型，对你的需求来说不够结构化——用户可能会在同一个“幻灯片”逻辑里插入多张图片/视频，反而增加了校验复杂度。而StructBlock+ListBlock的方式，让每张幻灯片都是一个独立的、规则统一的单元，不管是后台编辑还是前端渲染都更清晰。

内容的提问来源于stack exchange，提问作者NarūnasK