Django Crispy Form如何遍历{% crispy %}对象渲染表格列字段

问题根源 #

你遇到的Layout配置不生效的核心原因是|as_crispy_field过滤器仅会对单个字段应用基础的crispy样式渲染，不会读取并应用你在FormHelper中定义的Layout配置，Layout配置只有在使用{% crispy %}标签渲染整个表单时才会生效。你想实现的{% for field in {% crispy filter.form%} %}属于嵌套标签调用，Django模板语法不支持这种写法，且{% crispy %}标签返回的是渲染完成的完整HTML字符串，本身也不支持迭代。

可用解决方案 #

方案1：在FormHelper中配置字段外层标签，无需手动遍历

你不需要在模板中手动循环写<th>包裹字段，直接在FormHelper中指定每个字段的外层容器为<th>，之后直接用{% crispy %}标签渲染整行即可：

1. 修改表单类配置：

class CustomFiltersForm(forms.Form):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        self.helper.form_show_labels = False
        self.helper.form_tag = False
        self.helper.disable_csrf = True # GET请求无需CSRF校验可开启
        self.helper.layout = Layout()

        for field_name, field in self.fields.items():
            self.helper.layout.append(
                Field(
                    field_name, 
                    placeholder="Search " + field.label,
                    wrapper_class="", # 可清空默认外层div的类名，按需调整
                    outer_tag="th" # 直接指定字段外层渲染标签为th
                )
            )

2. 模板简化为如下写法：

{% load crispy_forms_tags %}
<tr>
    <form method="get" class="form-inline justify-content-center">
        {% crispy filter.form %}
        <input class='hidden-submit' type="submit"/>
    </form>
</tr>

方案2：必须手动遍历字段的场景

如果你的业务场景确实需要手动遍历每个字段做自定义处理，可选择以下两种实现：

方法A：直接给字段widget注入属性

把placeholder等需要的配置直接写到字段的widget属性中，不管用哪种渲染方式都会生效：

# 在Form的__init__方法中添加
for field_name, field in self.fields.items():
    field.widget.attrs['placeholder'] = f"Search {field.label}"
    # 其他需要的属性都可以在此处追加

模板可以沿用你原来的写法：

{% for field in filter.form %}
    <th>{{ field|as_crispy_field }}</th>
{% endfor %}

方法B：使用crispy_field标签

crispy提供的{% crispy_field %}标签支持读取FormHelper配置，也可手动传参，写法如下：

{% load crispy_forms_tags %}
{% for field in filter.form %}
    <th>{% crispy_field field placeholder="Search "|add:field.label %}</th>
{% endfor %}

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