Python中进行表单处理的方法详解

更新时间：2023年12月13日 13:59:26 作者：dulu~dulu

这篇文章主要为大家详细介绍了Python中进行表单处理的方法,分别是利用Flask和Flask-WTF处理表单,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一下

通过Flask处理表单

表单是在网页中搜集用户信息的各种表单控件的集合区域，表单控件包括文本框、单选框、复选框、提交按钮等，用于实现客户端和服务器端之间的数据交互。

利用Flask内置的功能对表单进行处理的过程：

首先在模板文件中通过HTML代码创建表单，然后通过请求上下文中的request.form对象获取以及验证表单数据，最后通过消息闪现给用户反馈正确或错误提示。

例如用户注册的案例:

（1）创建一个Flask项目，在项目中新建templates文件夹，在该文件夹下创建模板文件register.html，在该模板文件中使用<form>标签创建表单。

 <h1>注册页面</h1>
    {#给用户展示不同的消息闪现#}
    {% macro print_error(type) %}
        {% for message in get_flashed_messages(category_filter = (type)) %}
            <p class="error" style="color: red;
                display:inline;">{{ message }}</p>
        {% endfor %}
    {% endmacro %}
    <form action="" method=post>
        <span>用户名:</span><br>
        <input type=text name=username>{{ print_error('message') }}
        {{ print_error('info') }}<br>
        <span>密码:</span><br>
        <input type=password name=password><br>
        <span>确认密码:</span><br>
        <input type=password name=password2>{{ print_error('error') }}<br>
        <p><input type=submit value=注册></p>
    </form>

（2）在app.py文件中定义视图函数register()，该视图函数用于展示注册页面以及验证用户输入的注册数据是否符合要求。

@app.route('/register', methods=['GET', 'POST'])
def register():
    if request.method == 'POST':    # 判断请求方式
        username = request.form.get('username')  # 获取表单数据
        password = request.form.get('password')
        password2 = request.form.get('password2')
        if not all([username, password, password2]): # 验证数据的完整性
            flash('请填入完整信息', category='message')
        # 验证输入的数据是否符合要求
        elif len(username) < 3 and len(username) > 0 or len(username) > 15:
            flash('用户名长度大于3且小于15', category='info')
        elif password != password2: # 验证两次输入的密码是否一致
            flash('密码不一致', category='error')
        else:
            return '注册成功'
    return render_template('register.html')

通过Flask-WTF处理表单

处理表单涉及创建表单、验证表单数据、获取和保存表单数据、反馈错误提示等诸多操作，为了降低处理表单的难度，Flask提供了专门负责处理表单的扩展包——Flask-WTF。

Flask-WTF的安装

pip install flask-wtf

Flask-WTF是构建于 WTFForms之上的，所以引用的时候：

from flask_wtf import FlaskForm

常用字段类与表单控件的映射关系:

补充：datetime.date和datetime.datetime的区别

datetime.date类代表日期，它包含年、月和日的信息，但不包含具体的时间（小时、分钟和秒）信息。

datetime.date(year, month, day)构造函数创建一个日期对象，其中year、month和day分别表示年、月和日的整数值。

datetime.datetime类则代表日期和时间，它包含年、月、日以及具体的时间（小时、分钟和秒）信息。

datetime.datetime(year, month, day, hour=0, minute=0, second=0)构造函数创建一个日期时间对象，其中year、month、day、hour、minute和second分别表示年、月、日、小时、分钟和秒的整数值。

常用的字段类都继承自WTForms库的Field类，可以通过Field类的构造方法实例化所有字段类，以下是一些可配置的参数：

参数validators的值是一个列表，包含了一系列用于验证表单数据是否有效的验证器，只有当表单数据满足验证器的规则时，数据才能成功提交到服务器。

- 在使用验证器之前需要先从wtforms.validators模块中导入相应的类：

用Flask-WTF创建表单：

from flask import Flask, render_template
from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField
from wtforms.validators import DataRequired, Length, EqualTo
app = Flask(__name__)
class RegisterForm(FlaskForm):
    username = StringField(label='用户名：',
                    validators=[DataRequired(message='用户名不能为空'),
                            Length(3, 15, message='长度应该为3~15')])
    password = PasswordField('密码：',
                    validators=[DataRequired(message='密码不能为空')])
    password2 = PasswordField('确认密码：',
                    validators=[DataRequired(message='密码不能为空'),
                        EqualTo('password', message='两次密码不一致')])
    submit = SubmitField('注册')

使用Flask-WTF创建了注册表单，但此时在模板文件中还无法渲染创建的表单。

- 如果希望在模板文件中渲染通过Flask-WTF创建的表单：

① 需要在视图函数中将表单类的对象传递到模板文件中。

②在模板文件中获取表单字段，将表单字段渲染到HTML页面进行呈现。

#在项目的app.py文件中定义用于传递表单类对象的视图函数
from flask import render_template
#，默认情况下Flask-WTF为每个表单启用CSRF保护，因此需要在程序中设置密钥，
这样可以让Flask-WTF通过该密钥生成CSRF令牌，以便用CSRF令牌验证请求中表单数据的真伪。
app.secret_key = '34sdfji9453#$@'
@app.route('/register', methods=['GET', 'POST'])
def register():    
    form = RegisterForm()  
    return render_template('register_wtf.html', form=form)

在templates文件夹中创建模板文件register_wtf.html，并在该模板文件中获取表单字段

<body>
    <h1>注册页面</h1>
    <form method="post">
         {#获取username对应的标签名称#}
         <span>{{ form.username.label }}</span><br>  
         {{ form.username }}<br>  {#调用表单字段渲染为HTML#}
        <span>{{ form.password.label }}</span><br>
        {{ form.password }}<br>
        <span>{{ form.password2.label }}</span><br>
        {{ form.password2 }}<br>
        <p>{{ form.submit }}</p>
    </form>
</body>

则：app.py的完整代码如下：

from flask import Flask, render_template
from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField
from wtforms.validators import DataRequired, Length, EqualTo
from flask import render_template
app = Flask(__name__)
app.secret_key = '34sdfji9453#$@'
@app.route('/register', methods=['GET', 'POST'])
def register():
    form = RegisterForm()
    return render_template('register.html', form=form)
class RegisterForm(FlaskForm):
    username = StringField(label='用户名：',
                    validators=[DataRequired(message='用户名不能为空'),
                            Length(3, 15, message='长度应该为3~15')])
    password = PasswordField('密码：',
                    validators=[DataRequired(message='密码不能为空')])
    password2 = PasswordField('确认密码：',
                    validators=[DataRequired(message='密码不能为空'),
                        EqualTo('password', message='两次密码不一致')])
    submit = SubmitField('注册')
 
 
if __name__ == '__main__':
    app.run()

register的完整代码如下：

<body>
    <h1>注册页面</h1>
    <form method="post">
         {#获取username对应的标签名称#}
         <span>{{ form.username.label }}</span><br>
         {{ form.username }}<br>  {#调用表单字段渲染为HTML#}
        <span>{{ form.password.label }}</span><br>
        {{ form.password }}<br>
        <span>{{ form.password2.label }}</span><br>
        {{ form.password2 }}<br>
        <p>{{ form.submit }}</p>
    </form>
</body>

得到注册页面为：

通过Flask-WTF验证表单

表单数据验证分为客户端验证和服务端验证

客户端验证是指客户端（浏览器）对用户提交的数据进行校验。客户端验证可以通过多种方式进行验证，包括使用HTML5内置的验证属性、JavaScript表单验证库等。客户端验证可以实时动态提示用户输入是否正确，只有用户输入正确后才会将表单数据发送给服务器。

服务器端验证是指用户把表单数据提交到服务器端，由服务器端对表单数据进行校验。在服务器端校验时，若出现错误，则会将错误信息加入到响应进行返回，待用户修改后再次提交表单数据，直至通过校验为止。

- Flask-WTF的FlaskForm类中提供了用于验证表单数据的validate_on_submit()方法，该方法内部会调用表单验证器对表单数据进行验证，具体看如下示例：

(1)app.py创建表单

class RegisterForm(FlaskForm):
    username = StringField(label='用户名：', render_kw={'required': False},
                           validators=[DataRequired(message='用户名不能为空'),
                                       Length(3, 15, message='长度应该为3~15')])
    password = PasswordField('密码：', render_kw={'required': False},
                             validators=[DataRequired(message='密码不能为空')])
    password2 = PasswordField('确认密码：', render_kw={'required': False},
                              validators=[DataRequired(message='密码不能为空'),
                                          EqualTo('password', message='两次密码不一致')])
    submit = SubmitField('注册')

（2）通过validate_on_submit()对表单数据进行验证

validate_on_submit()方法的返回值是一个布尔值，若返回值为True，则表示用户提交的表单数据符合验证器定义的规则，说明通过验证；若返回值为False，则用户提交的表单数据不符合验证器定义的规则，说明未通过验证。

针对未通过验证的情况，FlaskForm会将错误消息添加到表单类的errors属性中，errors属性的值是一个匹配表单字段类属性到错误信息列表的字典。若需要获取具体的错误信息列表，则可以在模板文件中通过“form.字段名. errors”进行获取。

app = Flask(__name__)
app.secret_key = '34sdfji9453#$@'
@app.route('/register', methods=['GET', 'POST'])
def register():
    form = RegisterForm()
    if form.validate_on_submit():
        return '注册成功！'
    return render_template('register_verification.html', form=form)
if __name__ == '__main__':
    app.run()

(3) 在templates文件夹中创建模板文件register.html，并在该模板文件中获取表单字段

<form method="post">
        {# 定义宏循环遍历错误信息列表#}
        {% macro print_error(form_fields) %}
        {% for error_message in form_fields %}
            <p class="error" style="color: red;
                                 display:inline;" >{{ error_message }}</p>
        {% endfor %}
        {% endmacro %}
        <span>{{ form.username.label }}</span><br>
        {{ form.username }}{{ print_error(form.username.errors) }}<br>
        <span>{{ form.password.label }}</span><br>
        {{ form.password }}{{ print_error(form.password.errors) }}<br>
        <span>{{ form.password2.label }}</span><br>
        {{ form.password2 }}{{ print_error(form.password2.errors) }}<br>
        <p>{{ form.submit }}</p>
    </form>

到此这篇关于Python中进行表单处理的方法详解的文章就介绍到这了,更多相关Python表单处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

matplotlib.pyplot画图图片的二进制流的获取方法
今天小编就为大家分享一篇matplotlib.pyplot画图图片的二进制流的获取方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-05-05
Flask框架实现debug模式下计算pin码
pin码也就是flask在开启debug模式下，进行代码调试模式的进入密码。本文为大家整理了Flask框架在debug模式下计算pin码的方法，需要的可以参考一下
2023-02-02
python操作日志的封装方法(两种方法)
这篇文章主要介绍了python操作日志的封装方法，本文通过实例代码给大家介绍的非常详细，具有一定的参考借鉴价值 ,需要的朋友可以参考下
2019-05-05
Python爬取数据保存为Json格式的代码示例
今天小编就为大家分享一篇关于Python爬取数据保存为Json格式的代码示例，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-04-04
在jupyter notebook 添加 conda 环境的操作详解
这篇文章主要介绍了在jupyter notebook 添加 conda 环境的操作详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-04-04
Python爬取网易云音乐上评论火爆的歌曲
最近跟着网上教程学着用python爬取问题，于是就想试着扒一扒Python爬取网易云音乐上评论火爆的歌曲，下面这篇文章就主要介绍了利用Python如何爬取网易云音乐上那些评论火爆的歌曲,需要的朋友可以参考借鉴，一起来看看吧。
2017-01-01
教你用python将数据写入Excel文件中
Python作为一种脚本语言相较于shell具有更强大的文件处理能力,下面这篇文章主要给大家介绍了关于如何用python将数据写入Excel文件中的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-02-02
Python Flask框架开发之运用SocketIO实现WebSSH方法详解
Socket.IO本是一个面向实时web应用的JavaScript库，现在已成为拥有众多语言支持的Web即时通讯应用的框架。这篇文章主要介绍了Python 运用SocketIO实现WebSSH方法
2022-10-10
基于Python实现温度转换程序
这篇文章主要为大家详细介绍了如何基于Python实现简单的温度转换程序,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2023-10-10
python 列表递归求和、计数、求最大元素的实例
今天小编就为大家分享一篇python 列表递归求和、计数、求最大元素的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-11-11