使用Flask-WTF在PythonFlask中创建并验证表单

发布时间：2023-12-11 09:29:29

Flask-WTF是一个Flask扩展，用于创建和验证Web表单。它建立在WTForms库的基础上，并提供了在Flask应用中轻松使用表单的功能。

要使用Flask-WTF，首先需要安装它。可以通过以下命令使用pip安装：

pip install Flask-WTF

一旦安装了Flask-WTF，就可以在Flask应用中创建和验证表单。以下是一个使用Flask-WTF创建并验证表单的示例：

from flask import Flask, render_template, redirect
from flask_wtf import FlaskForm
from wtforms import StringField, SubmitField
from wtforms.validators import DataRequired

app = Flask(__name__)
app.config['SECRET_KEY'] = 'your-secret-key'

class MyForm(FlaskForm):
    name = StringField('Name', validators=[DataRequired()])
    submit = SubmitField('Submit')

@app.route('/', methods=['GET', 'POST'])
def index():
    form = MyForm()
    if form.validate_on_submit():
        return redirect('/success')
    return render_template('index.html', form=form)

@app.route('/success')
def success():
    return 'Form submitted successfully!'

if __name__ == '__main__':
    app.run()

在上面的示例中，我们首先导入必要的模块和类。Flask类负责创建和运行Flask应用，render_template函数用于渲染模板，redirect函数用于重定向用户。

然后，我们定义了一个FlaskForm类来创建表单。FlaskForm是一个基于WTForms的类，它允许我们定义表单字段和验证器。在这个例子中，我们使用StringField定义一个名称字段，并使用DataRequired验证器确保用户输入了一个名称。我们还定义了一个SubmitField，用于提交表单。

下一步是创建一个Flask应用实例，并将其配置为使用一个秘密密钥。这个密钥在应用中用于加密数据。

接下来，我们定义了一个index函数，用于处理根路径。在该函数中，我们首先创建了一个MyForm实例，并在GET请求中将其传递给模板进行渲染。在POST请求中，我们使用form.validate_on_submit()方法来检查表单是否被正确填写，并在验证通过后重定向到/success路径。

最后，我们定义了一个success函数，用于处理表单成功提交后的页面。

要将表单渲染为HTML，您还需要创建一个模板。在templates文件夹中创建一个名为index.html的文件，并添加以下内容：

<!DOCTYPE html>
<html>
<head>
    <title>Flask-WTF Example</title>
</head>
<body>
    <h1>Flask-WTF Example</h1>
    <form method="POST" action="/">
        {{ form.csrf_token }}
        {{ form.name.label }} {{ form.name(size=20) }}
        {{ form.submit }}
    </form>
</body>
</html>

在模板中，我们使用{{ form.csrf_token }}来渲染一个隐藏的CSRF令牌字段，以提供安全保护。然后，我们使用{{ form.name.label }}来渲染名称字段的标签，{{ form.name(size=20) }}来渲染文本框，并使用{{ form.submit }}渲染提交按钮。

运行示例代码后，访问http://localhost:5000将显示一个包含表单的页面。在输入名称并点击提交按钮后，将重定向到http://localhost:5000/success，并显示“Form submitted successfully!”的消息。

这只是Flask-WTF的基本用法示例。您可以根据自己的需求自定义和扩展表单。Flask-WTF提供了很多其他功能，如字段类型、验证器、表单布局等，可以根据需要进行使用。请查阅Flask-WTF的文档以获取更多信息。