如何使用Jinja2的batch过滤器以网格形式渲染Django formset？

完全可以用Jinja2的batch过滤器实现这种需求，核心思路是先把表单实例和对应的非表单数据配对，再按目标列数分组，最后通过嵌套循环渲染成表格结构。

步骤1：视图层准备配对数据 #

在视图里，将formset和动态非表单数据打包成一一对应的元组列表，确保两者长度匹配：

from django.shortcuts import render
from .forms import YourFormSet
from itertools import zip_longest  # 可选，处理数据长度不一致的场景

def spreadsheet_view(request):
    formset = YourFormSet(request.POST or None)
    # 示例动态非表单数据，可根据业务逻辑生成
    dynamic_extra_data = [
        "项目A备注", "项目B备注", "项目C备注",
        "项目D备注", "项目E备注"
    ]
    # 用zip配对，若数据长度不一致，用zip_longest填充默认值
    form_data_pairs = zip(formset, dynamic_extra_data)
    # form_data_pairs = zip_longest(formset, dynamic_extra_data, fillvalue="无备注")

    return render(request, 'spreadsheet_template.html', {
        'form_data_pairs': form_data_pairs,
        'formset': formset  # 用于渲染管理表单
    })

步骤2：模板层用batch渲染表格 #

在模板中，通过batch(N)把配对数据分成每N个一组（N为目标列数），再嵌套循环渲染行和单元格：

<form method="post">
    {% csrf_token %}
    <!-- 必须渲染formset的管理表单，否则提交无效 -->
    {{ formset.management_form }}

    <table border="1" cellpadding="8">
        {% for column_group in form_data_pairs|batch(3) %}
            <tr>
                {% for form, extra_info in column_group %}
                    <td>
                        <!-- 自定义渲染表单字段，替代默认的form.as_table -->
                        <div>
                            <label>{{ form.name.label }}:</label>
                            {{ form.name }}
                            {{ form.name.errors }}
                        </div>
                        <div>
                            <label>{{ form.quantity.label }}:</label>
                            {{ form.quantity }}
                            {{ form.quantity.errors }}
                        </div>
                        <!-- 渲染动态非表单信息 -->
                        <div style="margin-top:8px;">
                            <strong>备注:</strong> {{ extra_info }}
                        </div>
                    </td>
                {% endfor %}
                <!-- 填充最后一行的空白单元格（可选） -->
                {% for _ in range(3 - column_group|length) %}
                    <td>&nbsp;</td>
                {% endfor %}
            </tr>
        {% endfor %}
    </table>

    <button type="submit">提交</button>
</form>

关键注意事项 #

• 务必渲染{{ formset.management_form }}，这是Django识别formset提交数据的核心，缺失会导致表单无法正常处理。
• 如果非表单数据和formset长度不一致，用itertools.zip_longest替代zip，避免数据被截断。
• 表单字段的渲染可以完全自定义，根据电子表格布局调整字段顺序和样式，不必依赖默认的form.as_table/form.as_p。
• 空白单元格的填充逻辑可根据需求调整，比如用CSS隐藏或留空。

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