表单 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 %}
