Wagtail中PageChooserPanel不显示问题求助

你的核心问题是在StructBlock里混用了Django模型字段和Wagtail Block字段，并且错误地在Block类中定义了panels（这是模型类专属的配置，Block类不适用）。以下是具体修复步骤：

1. 替换models.ForeignKey为Wagtail的PageChooserBlock #

MenuItemBlock是Wagtail的StructBlock，不能直接使用Django的models.ForeignKey，必须改用Wagtail专门为Block设计的PageChooserBlock，它会自动渲染页面选择器界面。

2. 移除Block类中的panels配置 #

Wagtail的Block类（StructBlock、StreamBlock等）不需要手动定义panels，它会根据你声明的字段自动生成对应的编辑器界面，手动配置panels会导致界面渲染异常。

修复后的完整代码 #

from wagtail.core.blocks import (
    StructBlock, CharBlock, BooleanBlock, StreamBlock, PageChooserBlock
)
from wagtail.core.models import Page
from wagtail.snippets.models import register_snippet
from modelcluster.models import ClusterableModel
from wagtail.admin.edit_handlers import MultiFieldPanel, FieldPanel
from django.db import models
from django_extensions.db.fields import AutoSlugField


class MenuItemBlock(StructBlock):
    link_title = CharBlock(
        blank=True,
        null=True,
        max_length=50
    )

    link_url = CharBlock(
        max_length=500,
        blank=True
    )

    # 替换models.ForeignKey为PageChooserBlock
    link_page = PageChooserBlock(
        page_type="wagtailcore.Page",
        null=True,
        blank=True
    )
    
    open_in_new_tab = BooleanBlock(default=False, blank=True)

    @property
    def link(self):
        if self.link_page:
            return self.link_page.url
        elif self.link_url:
            return self.link_url
        return '#'

    @property
    def title(self):
        if self.link_page and not self.link_title:
            return self.link_page.title
        elif self.link_title:
            return self.link_title
        return 'Missing Title'

    class Meta:
        icon = 'plus'
        label = '菜单选项'
        # template = 'menu_item.html'


class SubMenuBlock(StreamBlock):
    sub_menu_items = MenuItemBlock()

    class Meta:
        icon = 'list-ul'
        label = '子菜单'
        # template = 'sub_menu.html'


@register_snippet
class Menu(ClusterableModel):
    name = models.CharField(max_length=255)
    slug = AutoSlugField(populate_from="name", editable=True)

    menu_items = StreamField([
        ('MenuItem', MenuItemBlock()),
        ('SubMenu', SubMenuBlock()),
    ], blank=True, use_json_field=True)

    panels = [
        MultiFieldPanel([
            FieldPanel("name"),
            FieldPanel("slug"),
        ], heading="菜单"),

        FieldPanel('menu_items', heading='菜单选项')
    ]

    def __str__(self):
        return self.name

关键说明 #

• PageChooserBlock：是Wagtail为Block场景设计的页面选择组件，功能和模型中的PageChooserPanel一致，但适配Block的渲染逻辑。
• Block与模型的区别：只有继承自models.Model的类（比如Menu模型）才需要通过panels配置编辑器界面，Block类本身通过字段定义自动生成界面，无需额外设置panels。

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