Wagtail：如何基于父页面动态过滤ForeignKey的FieldPanel选项？

要基于父页面过滤districtobject的下拉选项，最直接的方式是通过自定义页面表单修改字段的queryset，具体步骤如下：

1. 自定义页面表单类 #

创建继承自WagtailAdminPageForm的表单类，在初始化方法中根据父页面属性过滤选项：

from wagtail.admin.forms import WagtailAdminPageForm

class DistrictPageForm(WagtailAdminPageForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        # 获取当前页面的父页面（转换为具体模型实例）
        parent_page = self.instance.get_parent().specific
        
        # 根据父页面属性过滤DistrictTranslated条目
        # 示例：假设父页面是CountryPage，通过country字段关联地区
        if parent_page:
            # 替换为你的实际业务过滤逻辑
            self.fields['districtobject'].queryset = DistrictTranslated.objects.filter(country=parent_page.country)
        else:
            # 无父页面时（如新建顶级页面），可设置空选项或默认全集
            self.fields['districtobject'].queryset = DistrictTranslated.objects.none()

2. 关联表单到页面模型 #

在DistrictPage模型中指定使用自定义表单：

class DistrictPage(Page):
    districtobject = models.ForeignKey(DistrictTranslated, on_delete=models.SET_NULL, null=True, blank=True)
    streamfield  = StreamField(BasicStreamBlock, null=True, blank=True, use_json_field=True)

    content_panels = Page.content_panels + [
        FieldPanel('districtobject', classname="full"),
        FieldPanel('streamfield'),
    ]
    
    # 绑定自定义表单
    base_form_class = DistrictPageForm

多类型父页面适配 #

如果父页面可能是多种类型，可通过类型判断调整过滤逻辑：

# 在DistrictPageForm的__init__方法中修改
parent_page = self.instance.get_parent().specific
if isinstance(parent_page, CountryPage):
    self.fields['districtobject'].queryset = DistrictTranslated.objects.filter(country=parent_page.country)
elif isinstance(parent_page, RegionPage):
    self.fields['districtobject'].queryset = DistrictTranslated.objects.filter(region=parent_page.region)
else:
    # 默认显示全部选项
    self.fields['districtobject'].queryset = DistrictTranslated.objects.all()

备选方案：Wagtail钩子实现 #

若不想修改页面模型，也可通过construct_page_form钩子完成过滤：

from wagtail.core import hooks

@hooks.register('construct_page_form')
def filter_district_options(form_class, page, request, *args, **kwargs):
    if isinstance(page, DistrictPage):
        parent_page = page.get_parent().specific
        # 应用过滤逻辑
        form_class.base_fields['districtobject'].queryset = DistrictTranslated.objects.filter(country=parent_page.country)
    return form_class

内容的提问来源于stack exchange，提问作者Philipp S.