如何在Wagtail后台为外键下拉框添加筛选/搜索功能？

我的Wagtail后台面板中有一个关联Faculty模型的Django外键字段，但为课程选择教员时，下拉列表未提供搜索或筛选选项。

当前代码：

faculty = models.ForeignKey("Faculty", on_delete=models.CASCADE, related_name="courses")
FieldPanel("faculty"),

该代码在Wagtail后台生成基础下拉列表，需要实现带搜索/筛选功能的下拉框（类似select2风格的可搜索选择器）。

需求
在Wagtail后台选择教员时，为下拉列表添加筛选/搜索功能，优先采用select2风格搜索框或Wagtail内置解决方案。

已尝试方案
研究过使用FieldPanel，但不确定如何使其支持搜索。想知道是否应使用AutocompletePanel，或是有其他实现方式？

方法一：使用Wagtail内置的AutocompletePanel（推荐） #

Wagtail自带的AutocompletePanel专门为外键/多对多字段提供可搜索选择功能，完全匹配你的需求，操作步骤如下：

1. 导入AutocompletePanel
   在页面模型所在文件顶部添加导入语句：

from wagtail.admin.panels import AutocompletePanel

2. 替换原FieldPanel
   将代码中的FieldPanel("faculty")替换为：

AutocompletePanel("faculty"),

3. 配置Faculty模型的搜索字段

• 如果Faculty是Wagtail Page模型，无需额外配置；
• 如果是普通Django模型，需要添加search_fields定义可搜索字段：

from wagtail.search import index

class Faculty(models.Model):
    name = models.CharField(max_length=255)
    # 其他业务字段...

    search_fields = [
        index.SearchField('name'),
        # 可按需添加更多搜索字段，比如工号、邮箱等
    ]

完成以上配置后，后台的教员选择框会自动变为带搜索功能的select2风格下拉框，符合你需要的样式。

方法二：自定义Select2字段（特殊场景使用） #

如果需要更定制化的搜索逻辑，可以借助第三方包实现：

1. 安装依赖包：

pip install django-select2

2. 在项目settings.py中添加应用：

INSTALLED_APPS = [
    # 其他已安装应用
    'django_select2',
]

3. 自定义选择器并替换面板字段：

from django_select2.forms import ModelSelect2Widget
from wagtail.admin.panels import FieldPanel

class FacultySelectWidget(ModelSelect2Widget):
    model = Faculty
    search_fields = ['name__icontains']
    min_input_length = 1  # 设置触发搜索的最小输入长度

# 在页面模型的content_panels中使用
FieldPanel("faculty", widget=FacultySelectWidget),

此方法需要引入第三方依赖，仅在内置方案无法满足定制需求时使用。

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