表单 Flask-WTF - 使用

1 配置

可以使用Flask-WTF来处理web表单，在使用之前要先配置下，打开config.py，编辑添加如下内容

WTF_CSRF_ENABLED = True
SECRET_KEY = 'you-will-never-guess'

WTF_CSRF_ENABLED设置为True主要是开启CSRF保护，SECRET_KEY是为了实现CSRF保护，Flask-WTF需要应用程序去配置一个加密密钥。Flask-WTF使用这个密钥去生成加密令牌用于验证请求表单数据的真实性，注：为了提高安全性，密钥应该存储在一个环境变量中，而不是嵌入到代码中。配置完成后要通知Flask去加载这个配置文件，编辑app/__init__.py，添加如下内容

from flask import Flask

app = Flask(__name__)
app.config.from_object('config')

from app import views

2 表单类

使用Flask-WTF时，每个web表单是由继承自 Form 类的子类来展现的。该类在表单中定义了一组表单域，每个都表示为一个对象。每个表单域都可以连接到一个或多个 validators ； validators 是一个用于检查用户提交的输入是否合法的函数，app/forms.py 专门用来存放表单类，用例

from flask.ext.wtf import Form
from wtforms import StringField, SubmitField
from wtforms.validators import Required

class NameForm(Form):
    name = StringField('What is your name?', validators=[Required()])
    submit = SubmitField('Submit')

示例中， NameForm 表单有一个 name 文本框和 submit 提交按钮。 StringField 类表示一个 type="text" 属性的 <input> 标签。 SubmitField 类表示一个 type="submit" 属性的 <input> 标签。表单域构造函数的第一个参数是一个 label ，在渲染表单到HTML时会使用。StringField 构造函数包含可选参数 validators ，它定义了一组检查来验证用户提交的数据。 Required() 验证确保提交的表单域不为空

WTForms标准HTML表单域

WTForms验证

3 表单渲染模版

假设视图函数传递一个参数名为 form 的NameForm 实例给模板，模板就会生成一个简单的HTML表单，如下所示：假设名字为nameform.html

<form method="POST">
    { { form.name.label }} { { form.name() }}
    { { form.submit() }}
</form>

当然，结果是什么都没有。为了改变表单的外观显示，任何发送给该表单域的参数会被转换为HTML表单域属性；例如，你可以给定表单域 id 或 class 属性，然后定义CSS样式：即使有HTML属性，努力用这种方式渲染表单是非常重要的，所以最好是尽可能的使用Bootstrap自带的一系列表单样式。Flask-Bootstrap使用Bootstrap的预定义表单样式来提供高级的帮助函数来渲染整个Flask-WTF表单，这些操作都只需要一个调用即可完成

<form method="POST">
    { { form.name.label }} { { form.name(id='my-text-field') }}
    { { form.submit() }}
</form>
---完善 nameform.html

<!-- extend from base layout -->

{% extends "base.html" %}

{% block content %}

<h1>{{title}}</h1>

<form action="" method="post" name="nameform">

{{ form.hidden_tag() }}

{{ form.name.label }} {{ form.name() }}

{{ form.submit() }}

</form>

{% endblock %}

4 视图函数使用表单

from .forms import NameForm

@app.route('/nameform', methods=['GET', 'POST'])

def nameform():

form = NameForm()

"""

处理接收表格数据，Flask-WTF让这个工作变得简单，validate_on_submit

处理了所有表格的基本工作，只需要判断然后直接引用数据即可

调用validate_on_submit时，这个函数会尝试接收用户提交的所有数据，然后做下表格校验，

如果一切校验都通过，意味着数据可以被合法安全处理,如果校验不通过会直接刷新停在原来页面

那如何做错误信息提示呢？

"""

if form.validate_on_submit():

flash('%s' %(form.name.data))

return redirect('/index')

return render_template('nameform.html',

title='nameform',

form=form)

效果

5 出错提醒

name再加个校验器，需要输入最少6个字符，最多35个字符

class NameForm(Form):
    name = StringField('What is your name?', validators=[Required()， validators.Length(min=6, max=35)])
    submit = SubmitField('Submit')

点击无反应，我们希望是能提示用户错误信息，在哪里加，在渲染的html模版里面，错误信息会存放到form.FieldName.errors里面，改进渲染模版

<!-- extend from base layout -->

{% extends "base.html" %}

{% block content %}

<h1>{{title}}</h1>

<form action="" method="post" name="nameform">

{{ form.hidden_tag() }}

<p>

{{ form.name.label }} {{ form.name() }}

{% for error in form.name.errors %}

<span style="color: red;">[{{ error }}]</span>

{% endfor %}

</p>

<p>

{{ form.submit() }}

</p>

</form>

{% endblock %}