Flask-Security 使用 Flask-WTForms 来呈现和验证表单。在 Flask-Security 1.7.5 中,“security/_macros.html”中定义的默认render_field_with_errors 和render_field 宏是
{% macro render_field_with_errors(field) %}
<p>
{{ field.label }} {{ field(**kwargs)|safe }}
{% if field.errors %}
<ul>
{% for error in field.errors %}
<li>{{ error }}</li>
{% endfor %}
</ul>
{% endif %}
</p>
{% endmacro %}
{% macro render_field(field) %}
<p>{{ field(**kwargs)|safe }}</p>
{% endmacro %}
根据Flask-WTForms 0.10 docs,以上两个宏函数都接受...
... 关键字参数被转发到 WTForm 的字段函数,为我们呈现字段。关键字参数将作为 HTML 属性插入。
具体来说,{{ field(**kwargs)|safe }} 行将 HTML 转义的关键字参数传递给 field 函数。因此,您可以添加类,
{{ render_field_with_errors(login_user_form.email, class="form-control") }}
并且还可以覆盖默认的 HTML 属性,
{{ render_field_with_errors(login_user_form.email,
class="form-control", type="email", placeholder="Enter email") }}
{{ render_field(login_user_form.submit, class="btn btn-default", value="Submit" ) }}
此外,您可以通过修改上述宏来定义自己的宏。例如,如果您想使用 Bootstrap 警报来呈现表单验证错误,您可以定义宏函数 render_field_with_bootstrap_errors
{% macro render_field_with_bootstrap_errors(field) %}
<p>
{{ field.label }} {{ field(**kwargs)|safe }}
{% if field.errors %}
{% for error in field.errors %}
<div class="alert alert-danger" role="alert">{{ error }}</div>
{% endfor %}
{% endif %}
</p>
{% endmacro %}
添加您自己的宏非常简单。例如,您可以将自定义宏放在模板目录中的“custom_macros.html”文件中,然后将函数加载到模板中
{% from "custom_macros.html" import render_field_with_bootstrap_errors %}
这样,很容易修改宏来使用不同的 Bootstrap 功能。