<form method="post">    <input type="text" name="username" placeholder="用户名">form>

WTForms：支持在Python中使用类定义表单，然后通过类定义生成对应的HTML代码。

4.2 使用Flask-WTF

Flask-WTF在Flask中集成了表单数据解析、CSRF保护、文件上传等功能。

# 设置密钥，flask-wtf使用程序密钥来对csrf令牌进行签名（？）app.secret_key = 'secret string'

定义表单类：

from wtforms import Fromclass LoginForm(Form):    ...

• 常用的WTForms字段、实例化字段常用参数、常用的WTForms验证器，见（p107）。

输出HTML代码：

>>> form = LoginForm()>>> form.username()  # 假设在类中定义了username字段>>> form.username.label()

• 添加额外属性：输出的字段HTML代码默认只包含id和name属性，其他属性可以：
  • 1、使用render_kw属性（p109）
  • 2、在调用时传入

在模板中渲染表单：我们需要把表单类实例传入模板，然后再模板中调用表单类的属性即可获取字段对应的HTML代码。

return render_template('basic.html', form=form)

<form method="post">    {{ form.csrf_token }}    {{ form.username.label }}    {{ form.username(class='form-contorl') }} form>

• CSRF字段：在提交表单后会自动验证该字段，为使验证通过，需渲染。

• 可以手动编写HTML表单的代码，name属性与表单类保持一致。

4.3 处理表单数据

1 过程：解析请求 --> 转换为Python数据类型 --> 验证 --> 处理。

2 提交表单：在HTML中，当标签声明的表单中类型为submit的提交字段被点击时，就会创建一个提交表单的HTTP请求。

HTML表单中控制提交行为的属性：action（目标URL），method（HTTP请求方法），enctype（表单数据编码类型）。（p112）

3 验证表单数据：

• 客户端验证：可以实时动态提示用户的输入是否正确，降低服务器负载。可以通过HTML5内置的验证属性，或Javascript实现。
• 服务器端验证：必须的，因为客户端不可靠。

• WTForms验证机制：实例化表单类时传入数据，然后调用实例的validate()方法，错误消息会存储到实例的errors属性对应的字典中。

>>> form.errors # 错误消息字典

• 获取数据：data属性是一个匹配所有字段与对应数据的字典。

>>> form.username.data

• PRG模式：（Post/Redirect/Get)，在浏览器中，刷新页面时的默认行为是发送上一个请求，会导致重复提交表单。因此在处理表单后应返回一个重定向响应（GET）。

4 渲染错误消息：WTForms会把错误消息添加到表单类的errors属性中，这是一个匹配作为表单字段的类属性到对应的错误消息列表的字典。

>>> form.username.errors

4.4 表单进阶实践

简化表单处理过程的技巧，以及表单的一些非常规应用。

1 设置错误消息语言：如下，所有继承MyBaseForm的表单类，将使用新设置的错误消息默认语言。

from flask_wtf import FlaskForm app = Flask(__name__)app.config['WTF_I18N_ENABLED'] = Falseclass MyBaseForm(FlaskForm):    class Meta:        locals = ['zh']    class HelloFrom(MyBaseForm):    ...

疑惑：类内部再定义一个Meta类是什么操作？

2 使用宏渲染表单：在模板中渲染表单时，存在大量的重复工作：获取定义、获取定义、渲染错误消息。为了避免每一个字段重复这些代码，可以创建一个宏。(p120)

{% macro form_field(field) %}{{ field.label}}
{{ field(**kwargs) }}
{% if field.errors %}{% for error in field.errors %}{{ error }}{% endfor %}{% endif %}{% end macro %}

3 自定义验证器：验证器是指在定义字段时传入validators参数列表的可调用对象，接受form和field（字段）两个位置参数。(p121)

• 行内验证器：在表单类中定义，用来验证某个特定的字段。
• 全局验证器：可重用。定义一个函数，在验证不通过时抛出ValidateionError异常。若需支持参数，可用工厂函数形式。

工厂函数：返回一个可调用对象的函数。

4 文件上传：

• 渲染字段：在HTML中，渲染一个文件上传字段只需要将字段的type属性值设置为file。

<input type="file">

app.config['MAX_CONTENT_LENGTH'] = 3 * 1024 * 1024

request.files.get('photo')# 在Flask-WTF中f = form.photo.data

if form.validata_on_submit():    if form.save.data:        ...    if form.publish.data:        ...