Flask表单基本介绍

Flask是一个用Python编写的轻量级Web应用框架。在Web应用中，表单的使用对于接收和处理用户输入起着至关重要的作用。WTForms库通常负责Flask表单的渲染，它是一个表单处理和验证库，可以与Flask无缝集成。清晰、简洁、安全的表单类可以通过WTForms定义，并且可以方便地用于Flask视图和模板。

从Flask-WTF提供的FlaskForm类开始，渲染表单的第一步是创建一个表单类。您可以在此表单类中定义各种字段（Field），例如文本框、选择框、按钮等，并设置相应的验证器。（Validator）确保输入数据符合特定要求。

一旦定义了表单类，就可以在Flask视图中创建表单对象，并在模板中渲染。模板渲染是通过Jinja2模板引擎完成的，它可以将表单对象转换成HTML表单。这个过程由Flask应用的渲染模板函数render_template自动处理。

第二，创建和渲染表单类。

需要导入WTForms提供的基本字段和验证器来创建表单类。举例来说，创建一个简单的登录表，包括两个字段：用户名和密码，每个字段都可以设置一些验证器，例如输入内容不是空的，长度限制等等。

下面是登录表单类的简单定义：

  from flask_wtf import FlaskForm from wtforms import StringField, PasswordField from wtforms.validators import InputRequired, Length class LoginForm(FlaskForm): username = StringField('Username', validators=[InputRequired(), Length(min=4, max=25)]) password = PasswordField('Password', validators=[InputRequired(), Length(min=6, max=35)])

在Flask视图中，您可以对这个表单类进行实例化，并将其传输到HTML模板中进行渲染。下面的代码显示了如何处理视图函数中的GET和POST请求，并渲染登录表:

  from flask import Flask, render_template, redirect, url_for from forms import LoginForm app = Flask(__name__) app.secret_key = 'your_secret_key' @app.route('/login', methods=['GET', 'POST']) def login(): form = LoginForm() if form.validate_on_submit(): # 对表单数据进行验证 return redirect(url_for('success')) return render_template('login.html', form=form) if __name__ == '__main__': app.run(debug=True)

您可以使用Flask-WTF提供的快捷方法来渲染Jinja2模板中的表单字段。举例来说，下面的login.在html模板中，{{ form.username() }}和{{ form.password() }}用户名和密码输入框进行渲染。

  <!DOCTYPE html> <html> <head> <title>登录</title> </head> <body> <form method="post"> {{ form.hidden_tag() }} <p>{{ form.username.label }} {{ form.username(size=20) }}</p> <p>{{ form.password.label }} {{ form.password(size=20) }}</p> <p><button type="submit">登录</button></p> </form> </body> </html>

使用Flask-WTF进行CSRF保护

跨站请求在Web开发中伪造。（CSRF）这是一种常见的攻击方法。为抵御这种攻击，Flask-CSRF保护机制集成在WTF框架中。使用Flask-WTF实现CSRF保护非常简单，只需在表格中加入一个隐藏的CSRF令牌字段，提交的表格将自动携带令牌进行验证。

打开CSRF保护需要设置一个安全的密钥，并确保POST请求用于提交所有表单，并在HTML模板中使用。{{ form.hidden_tag() }}将CSRF令牌的隐藏字段渲染出来。如不包含CSRF令牌或令牌不正确，表格提交将失败。

以前的登录表格示例已经使用过了。{{ form.hidden_tag() }}添加CSRF令牌是保护CSRF攻击的关键。请注意，为了保护CSRF生效，在创建Flask应用程序时必须设置一个秘密密钥，例如上述代码中的应用程序。.secret_key。

自定义表单字段和验证器

为了满足特殊的应用场景需求，WTForms允许开发者定制表单字段和验证器。定制字段通常会在现有字段的基础上添加一些特定的功能，例如，定制的密码输入框可以在验证过程中进行密码加密。而且定制验证器可以让开发者定义新的验证逻辑，例如，检查用户名是否已经存在于数据库中。

下面是定制验证器的例子，假设我们需要验证用户名是否已经注册：

  from wtforms import ValidationError def is_username_exists(form, field): if UsernameAlreadyExistCheck(field.data): raise ValidationError('Username already exists.') class CustomLoginForm(FlaskForm): username = StringField('Username', validators=[InputRequired(), is_username_exists]) # ... other fields ...

WTForms将自动处理这些自定义验证器，模板中的渲染方法与前面的例子相同。WTForms在验证失败时，还可以为模板提供相应的错误信息输出，让用户得到及时的反馈。

表格样式和布局五、表格样式

表格不仅需要满足功能要求，还需要良好的用户体验。这就需要开发者在HTML模板中对表格进行适当的风格和布局。Flask没有内置的表格风格功能，但可以很容易地与CSS框架(如Bootstrap)一起使用，从而快速实现美观和响应的面板。

通过在渲染表单字段时传递CSS等属性，可以很容易地为表单元素添加样式。例如，您可以在上面登录表单的用户名和密码输入框中添加Bootstrap样式:

  <p>{{ form.username.label }} {{ form.username(class="form-control") }}</p> <p>{{ form.password.label }} {{ form.password(class="form-control") }}</p>

与此同时，您还可以使用其它HTML属性来提高表单的可用性和网页的无障碍性。举例来说，输入提示是通过添加placeholder属性来提供的，或者使用required属性标记表单字段作为必填项。

上面是Flask表单渲染的各个方面。Flask通过与WTForms的紧密集成，为开发者创建和渲染Web表单提供了一种强大而灵活的方式，从而使Flask成为开发现代Web应用的绝佳选择。