基于Django Wagtail实现无需新建模型的动态表单创建咨询

嘿，你的需求用Wagtail的StreamField + StructBlocks绝对是最优解——完全能避开运行时动态建模型的各种坑（毕竟那玩意儿搞不好就会弄乱数据库，后期维护也头大）。下面给你一步步拆解具体怎么实现：

1. 先定义各类表单字段的基础Block #

首先得给常用的表单输入类型（比如单行文本、下拉选择）建对应的StructBlock，让主用户能设置字段的标签、是否必填这些属性。每个Block就对应一个可拖拽的表单组件：

from wagtail.core.blocks import StructBlock, CharBlock, TextBlock, BooleanBlock

class SingleLineTextFieldBlock(StructBlock):
    label = CharBlock(required=True, label="字段标签")
    is_required = BooleanBlock(required=False, label="是否必填")
    placeholder = CharBlock(required=False, label="输入提示文本")

    class Meta:
        icon = "edit"
        label = "单行文本字段"

class MultiLineTextFieldBlock(StructBlock):
    label = CharBlock(required=True, label="字段标签")
    is_required = BooleanBlock(required=False, label="是否必填")

    class Meta:
        icon = "doc-full"
        label = "多行文本字段"

class DropdownFieldBlock(StructBlock):
    label = CharBlock(required=True, label="字段标签")
    is_required = BooleanBlock(required=False, label="是否必填")
    choices = CharBlock(required=True, label="选项（逗号分隔）", help_text="示例：选项1,选项2,选项3")

    class Meta:
        icon = "arrow-down-big"
        label = "下拉选择字段"

你还可以根据需求扩展更多类型，比如日期选择、单选框组这些，只需要新增对应的StructBlock就行。

2. 用StreamField让主用户自由组合表单 #

接下来在主用户对应的Page模型（或者Snippet，看你主用户的存储逻辑）里加一个StreamField，把上面定义的Block都加进去，这样主用户就能在Wagtail后台拖拽组合出自己需要的表单了：

from wagtail.core.models import Page
from wagtail.core.fields import StreamField

class FormCreatorPage(Page):
    # 主用户用来创建表单的专属页面
    form_fields = StreamField([
        ('single_line_text', SingleLineTextFieldBlock()),
        ('multi_line_text', MultiLineTextFieldBlock()),
        ('dropdown', DropdownFieldBlock()),
        # 后续扩展的字段类型都可以加在这里
    ], blank=True, use_json_field=True)

    content_panels = Page.content_panels + [
        FieldPanel('form_fields'),
    ]

    class Meta:
        verbose_name = "自定义表单创建页"

这里记得加use_json_field=True（Wagtail 2.15+支持），把StreamField的数据存在JSON字段里，不用额外建表，更适合动态内容的存储。

3. 前端渲染动态表单 #

主用户创建好表单后，需要在前端把StreamField里的Block转换成HTML表单。你可以在模板里遍历form_fields，根据Block类型渲染对应的输入控件：

<form method="post" action="{% url 'submit_dynamic_form' page.id %}">
    {% csrf_token %}
    {% for block in page.form_fields %}
        {% if block.block_type == 'single_line_text' %}
            <div class="form-group">
                <label for="field-{{ forloop.counter }}">{{ block.value.label }}{% if block.value.is_required %}*{% endif %}</label>
                <input type="text" 
                       id="field-{{ forloop.counter }}" 
                       name="field-{{ forloop.counter }}" 
                       {% if block.value.is_required %}required{% endif %}
                       placeholder="{{ block.value.placeholder }}">
            </div>
        {% elif block.block_type == 'multi_line_text' %}
            <div class="form-group">
                <label for="field-{{ forloop.counter }}">{{ block.value.label }}{% if block.value.is_required %}*{% endif %}</label>
                <textarea id="field-{{ forloop.counter }}" 
                          name="field-{{ forloop.counter }}" 
                          {% if block.value.is_required %}required{% endif %}></textarea>
            </div>
        {% elif block.block_type == 'dropdown' %}
            <div class="form-group">
                <label for="field-{{ forloop.counter }}">{{ block.value.label }}{% if block.value.is_required %}*{% endif %}</label>
                <select id="field-{{ forloop.counter }}" 
                        name="field-{{ forloop.counter }}" 
                        {% if block.value.is_required %}required{% endif %}>
                    <option value="">请选择</option>
                    {% for choice in block.value.choices.split(',') %}
                        <option value="{{ choice.strip }}">{{ choice.strip }}</option>
                    {% endfor %}
                </select>
            </div>
        {% endif %}
    {% endfor %}
    <button type="submit">提交表单</button>
</form>

4. 处理表单提交的数据 #

因为表单是动态生成的，没法用Django的ModelForm，所以需要手动处理提交数据，同时验证必填字段。建议用一个通用模型存储提交记录，用JSONField保存动态字段的键值对：

首先定义存储模型：

from django.db import models
from wagtail.core.models import Page

class DynamicFormSubmission(models.Model):
    form_page = models.ForeignKey(Page, on_delete=models.CASCADE, related_name='submissions')
    submitted_at = models.DateTimeField(auto_now_add=True)
    submission_data = models.JSONField()  # 存储字段标签和对应值的键值对
    # 可以额外加提交者邮箱、用户名等字段，根据需求调整

    class Meta:
        verbose_name = "动态表单提交记录"

然后写处理提交的视图：

from django.shortcuts import get_object_or_404, redirect
from django.http import HttpResponseBadRequest
from .models import FormCreatorPage, DynamicFormSubmission

def submit_dynamic_form(request, page_id):
    form_page = get_object_or_404(FormCreatorPage, id=page_id)
    if request.method == 'POST':
        submission_data = {}
        # 遍历表单字段，验证并收集数据
        for index, block in enumerate(form_page.form_fields):
            field_name = f'field-{index+1}'
            field_value = request.POST.get(field_name, '')
            # 验证必填字段
            if block.value.is_required and not field_value.strip():
                return HttpResponseBadRequest(f"字段「{block.value.label}」为必填项")
            # 用字段标签作为键，方便后续查看数据
            submission_data[block.value.label] = field_value
        
        # 保存提交记录
        DynamicFormSubmission.objects.create(
            form_page=form_page,
            submission_data=submission_data,
            # 如果需要，可以从request获取提交者信息，比如request.user.email
        )
        # 提交成功后跳转，比如回到表单页加个成功提示
        return redirect(f"{form_page.url}?submitted=true")
    else:
        return HttpResponseBadRequest("仅支持POST请求")

5. 额外优化小建议 #

• 表单预览：给主用户加个预览功能，让他们在发布前能看到表单的实际效果，避免设置错误。
• 数据导出：给主用户提供导出提交数据的功能，比如导出成CSV，遍历JSONField里的数据生成表格就行。
• 权限控制：用Wagtail的权限系统配置，确保只有对应的主用户能查看、编辑自己的表单和提交记录。

这样一套流程下来，完全不用新建模型或者执行迁移，主用户可以自由创建符合自己需求的表单，所有动态内容都存在JSON字段里，既灵活又安全。

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