Wagtail 5.1.1 Snippets创建与编辑视图面板异常问题求助

问题原因 #

你自定义EditView和CreateView时重写get_panel的方式不符合Wagtail的表单构建逻辑，导致：

• 配置的readonly=True未被正确应用
• Wagtail无法识别面板中已包含tag字段，触发render_missing_fields()将其重复渲染在页面末尾

正确实现方式 #

不需要手动重写get_panel方法，直接在自定义视图类中指定panels属性即可：

1. 保留原有的面板配置

create_panels = [
    FieldPanel("name"),
    FieldPanel("tag"),
    FieldPanel("is_valid"),
]

edit_panels = [
    FieldPanel("name"),
    FieldPanel("tag", readonly=True),
    FieldPanel("is_valid"),
]

2. 自定义视图类并指定面板

from wagtail.snippets.views.snippets import EditView, CreateView
from wagtail.snippets.viewsets import SnippetViewSet

class EditableEditView(EditView):
    panels = edit_panels

class EditableCreateView(CreateView):
    panels = create_panels

3. 配置SnippetViewSet

class EditableSnippetViewSet(SnippetViewSet):
    model = MyModel
    edit_view_class = EditableEditView
    create_view_class = EditableCreateView
    # 其他配置（如menu_label、icon等）

替代方案：通过SnippetViewSet动态返回面板 #

如果不想自定义视图类，也可以直接在SnippetViewSet中重写get_panels方法，根据当前视图类型切换面板：

class EditableSnippetViewSet(SnippetViewSet):
    model = MyModel

    def get_panels(self, request, *args, **kwargs):
        # 判断当前是否为创建视图
        if self.action == 'create':
            return create_panels
        return edit_panels

原理说明 #

Wagtail的Snippet视图类会通过panels属性自动处理表单字段的渲染逻辑，包括只读状态的设置。之前重写get_panel的方式绕过了这一流程，导致面板配置未被正确整合到表单中，最终出现字段重复和只读失效的问题。

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