Wagtail自定义批量操作能否添加自定义输入字段？

完全支持添加自定义输入字段，Wagtail原生的「将图片添加到合集」批量操作就是带选择字段的标准实现，你可以按下面的方式开发：

核心实现逻辑 #

• 自定义Django表单类，定义你需要的字段（比如选择目标页面的ModelChoiceField）
• 继承Wagtail的批量操作确认视图，绑定自定义表单，重写表单校验通过后的业务逻辑
• 覆写确认页模板，在form_section块内渲染自定义表单字段即可，不需要额外写独立表单标签，默认模板已经内置了表单容器、CSRF校验、选中项隐藏传参的逻辑。

代码示例 #

1. 后端视图与批量动作注册 #

from django import forms
from wagtail.images.bulk_actions import ImageBulkAction
from wagtail.models import Page
from wagtail.admin.views.bulk_actions import BulkActionConfirmationView
from wagtail.admin.widgets import AdminPageChooser

# 自定义带目标页面选择的表单
class AddToPageForm(forms.Form):
    target_page = forms.ModelChoiceField(
        queryset=Page.objects.live(),
        label="目标页面",
        required=True,
        # 可以直接用Wagtail内置的页面选择器组件，和普通管理页用法一致
        widget=AdminPageChooser(can_choose_root=False)
    )

# 自定义批量操作确认视图
class AddToPageConfirmationView(BulkActionConfirmationView):
    form_class = AddToPageForm

    def form_valid(self, form):
        # 获取当前选中的所有图片实例
        selected_images = self.get_queryset()
        # 获取用户选择的目标页面
        target_page = form.cleaned_data["target_page"]
        
        # 下方写你自己的业务逻辑：比如批量创建ImagePageRelation关联记录
        # for image in selected_images:
        #     ImagePageRelation.objects.create(page=target_page, image=image)

        return super().form_valid(form)

# 注册批量动作
class AddImagesToPageBulkAction(ImageBulkAction):
    display_name = "添加图片到指定页面"
    action_type = "add_images_to_page"
    aria_label = "将选中图片批量关联到指定页面"
    # 指定自定义模板路径
    template_name = "bulk_actions/confirm_add_to_page.html"
    confirmation_view = AddToPageConfirmationView

2. 自定义确认页模板 #

创建模板文件 templates/bulk_actions/confirm_add_to_page.html：

{% extends "wagtailadmin/bulk_actions/confirmation/base.html" %}
{% load i18n wagtailadmin_tags %}

{% block extra_css %}
{{ block.super }}
{# 如果用了AdminPageChooser需要引入对应样式 #}
{% include "wagtailadmin/pages/_editor_css.html" %}
{% endblock %}

{% block extra_js %}
{{ block.super }}
{# 如果用了AdminPageChooser需要引入对应JS #}
{% include "wagtailadmin/pages/_editor_js.html" %}
{% endblock %}

{% block form_section %}
{% if items %}
    {% trans '确认添加' as action_button_text %}
    {% trans "取消操作" as no_action_button_text %}
    {# 渲染自定义表单字段 #}
    <div class="field">
        {{ form.target_page.label_tag }}
        <div class="field-content">
            {{ form.target_page }}
        </div>
        {% if form.target_page.errors %}
            <p class="error-message">{{ form.target_page.errors.0 }}</p>
        {% endif %}
    </div>
    {# 引入默认的提交、返回按钮，不需要自己写form标签 #}
    {% include 'wagtailadmin/bulk_actions/confirmation/form.html' with action_button_class="serious" %}
{% else %}
    {% include 'wagtailadmin/bulk_actions/confirmation/go_back.html' %}
{% endif %}
{% endblock form_section %}

实现效果参考 #

你要做的效果和Wagtail原生的批量添加图片到合集完全一致：

注意：不要在form_section块里额外加<form>标签，默认引入的form.html已经包裹了正确的表单标签、CSRF令牌和选中项的隐藏传参字段，重复加表单标签会导致提交失效。

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