Flask-WTF如何向Jinja模板传递表单额外自定义参数

WTForms（含Flask-WTF）实例化表单时，只会自动绑定两类传入参数：一是表单类中提前声明的字段属性，二是obj参数中与字段名匹配的属性。你额外传入的form_class不属于这两类，不会自动挂载到表单实例上，因此模板中无法读取到值。
另外你的模板中<form>标签写了两个class属性，HTML中后定义的同名属性会覆盖前者，就算你正确传入了form_class，后面写死的class="text-start"也会把前面的动态class冲掉，这个问题需要先修复。

方案1：表单类预声明自定义属性（最稳定） #

在表单类定义中提前声明需要用到的自定义属性，设置好默认值，后续实例化时传入的同名参数会自动覆盖默认值，不需要额外处理。
表单类定义示例：

from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField

class UserForm(FlaskForm):
    # 自定义样式属性，设置默认值
    form_class = "text-start"
    # 原有业务字段
    username = StringField("用户名")
    password = PasswordField("密码")

修复模板中重复的class属性，同时加判断避免未设置render_kw时抛出属性错误：

{% macro build_form(form) %}
{# 合并原来重复的class属性，只保留一个动态绑定项 #}
<form class="{{ form.form_class }}" role="form" method="post" action="">
  {{ form.hidden_tag() }}
  {% for field in form if field.widget.input_type != 'hidden' %}
  <div class="{{ field.render_kw.container2_class if field.render_kw and 'container2_class' in field.render_kw else '' }}">
    <div class="{{ field.render_kw.container1_class if field.render_kw and 'container1_class' in field.render_kw else '' }}">
      <label class="form-label"> {{ field.label }}</label>
      {{ field}}
    </div>
  </div>
...

这时候你原来的实例化代码就可以正常生效：

# 传入的form_class="row"会覆盖类上的默认值
user_form = UserForm(obj=user, form_class="row")

方案2：实例化后手动挂载属性（无需修改表单类） #

如果不想改动原有表单类定义，实例化完成后直接给表单对象追加自定义属性即可，适合临时加参数的场景：

user_form = UserForm(obj=user)
# 手动绑定自定义样式属性
user_form.form_class = "row"

# 给字段设置容器class同理，直接修改对应字段的render_kw即可
user_form.username.render_kw = {
    "container1_class": "col-md-6",
    "container2_class": "mb-3"
}

方案3：通过宏参数传递样式（逻辑解耦推荐） #

如果样式类和渲染场景强相关、不属于表单本身的业务属性，更推荐直接把样式作为参数传给渲染宏，不需要往表单实例里塞和表单逻辑无关的属性，灵活度最高。
修改宏定义，增加样式参数：

{% macro build_form(form, form_class="text-start", default_container_class="mb-3") %}
<form class="{{ form_class }}" role="form" method="post" action="">
  {{ form.hidden_tag() }}
  {% for field in form if field.widget.input_type != 'hidden' %}
  {% set c2_class = field.render_kw.container2_class if field.render_kw and 'container2_class' in field.render_kw else default_container_class %}
  <div class="{{ c2_class }}">
    <div class="{{ field.render_kw.container1_class if field.render_kw and 'container1_class' in field.render_kw else '' }}">
      <label class="form-label"> {{ field.label }}</label>
      {{ field}}
    </div>
  </div>
  {% endfor %}
</form>
{% endmacro %}

调用宏时直接传入需要的样式即可，不需要修改Python侧的表单实例化代码：

{{ build_form(user_form, form_class="row text-start", default_container_class="col-12 mb-3") }}

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