Wagtail 2.16.3中动态限制编辑页字段选项的实现问题

要在Wagtail 2.16.3中实现产品页面仅显示所属分类下的标签选项，核心是在编辑表单初始化时动态过滤标签的查询集——直接修改Widget的choices会被表单初始化逻辑覆盖，因此需要从表单层面入手处理。具体步骤如下：

1. 自定义产品页面的编辑表单 #

在models.py中添加自定义Wagtail页面表单，在表单初始化时根据当前产品页面的父分类过滤标签：

from wagtail.admin.forms import WagtailAdminPageForm
from django.http import HttpRequest

class ProductPageForm(WagtailAdminPageForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        # 获取父分类页面ID：兼容编辑已有页面和新建页面两种场景
        parent_id = None
        request = kwargs.get('request')
        
        # 新建页面时，从请求参数中获取父页面ID
        if request and isinstance(request, HttpRequest):
            parent_id = request.GET.get('parent_id')
        
        # 编辑已有页面时，从当前页面的父页面获取ID
        if not parent_id and self.instance.pk:
            parent_category = self.instance.get_parent().specific
            parent_id = parent_category.pk
        
        # 过滤标签查询集，仅显示当前分类下的标签
        if parent_id:
            self.fields['tags'].queryset = ProductTag.objects.filter(category_id=parent_id)

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

修改ProductPage模型，指定使用上面定义的自定义表单：

class ProductPage(Page):
    parent_page_types = ["products.ProductCategoryIndexPage"]
 
    tags = ParentalManyToManyField("ProductTag", related_name="products")
    
    # 新增：指定自定义编辑表单
    base_form_class = ProductPageForm
    
    content_panels = Page.content_panels + [
        FieldPanel("tags", widget=widgets.CheckboxSelectMultiple()),
    ]

原理说明 #

Wagtail的页面编辑表单会在初始化阶段重新从字段的queryset生成选项，因此直接在Panel中修改Widget的choices会被覆盖。通过自定义base_form_class，在表单的__init__方法中动态修改tags字段的queryset，能确保选项始终是当前分类下的标签，同时兼容新建和编辑两种场景。

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