（二十八）Flask之wtforms库【上手使用篇】

news/2024/10/22 13:40:54/

目录：

  • 每篇前言：
  • 用户登录验证：
  • 用户注册验证：
    • 使用示例：
  • 抽象解读使用wtforms编写的类：
    • 简单谈一嘴：
    • 开始抽象：

每篇前言：

  • 🏆🏆作者介绍：【孤寒者】—CSDN全栈领域优质创作者、HDZ核心组成员、华为云享专家Python全栈领域博主、CSDN原力计划作者

  • 🔥🔥本文已收录于Flask框架从入门到实战专栏：《Flask框架从入门到实战》
  • 🔥🔥热门专栏推荐：《Python全栈系列教程》、《爬虫从入门到精通系列教程》、《爬虫进阶+实战系列教程》、《Scrapy框架从入门到实战》、《Flask框架从入门到实战》、《Django框架从入门到实战》、《Tornado框架从入门到实战》、《前端系列教程》。
  • 📝​📝本专栏面向广大程序猿，为的是大家都做到Python全栈技术从入门到精通，穿插有很多实战优化点。
  • 🎉🎉订阅专栏后可私聊进一千多人Python全栈交流群（手把手教学，问题解答）； 进群可领取Python全栈教程视频 + 多得数不过来的计算机书籍：基础、Web、爬虫、数据分析、可视化、机器学习、深度学习、人工智能、算法、面试题等。
  • 🚀🚀加入我一起学习进步，一个人可以走的很快，一群人才能走的更远！
在这里插入图片描述

WTForms 是一个用于处理Web表单的Python库。它设计简单，易于使用，广泛用于Web应用程序的表单处理，特别是与Flask等框架一起使用。

wtforms依照功能类别来说有以下几个类别：

  • Forms: 主要用于表单验证、字段定义、HTML生成，并把各种验证流程聚集在一起进行验证。
  • Fields: 主要负责渲染(生成HTML)和数据转换。
  • Validator:主要用于验证用户输入的数据的合法性。比如Length验证器可以用于验证输入数据的长度。
  • Widgets：html插件，允许使用者在字段中通过该字典自定义html小部件。
  • Meta：用于使用者自定义wtforms功能，例如csrf功能开启。
  • Extensions：丰富的扩展库，可以与其他框架结合使用，例如django。
pip install wtforms==2.1

官方文档：

  • https://wtforms.readthedocs.io/en/stable/index.html#

用户登录验证：

  • 当用户登录时，需要对用户提交的用户名和密码进行多种格式校验，如：

    用户名不能为空；长度必须大于6；

    密码不能为空；长度必须大于12；密码必须包含字母、数字、特殊字符等（通过正则自定义）…

from flask import Flask, render_template, request, redirect
from wtforms import Form
from wtforms.fields import core, simple
from wtforms import validators
from wtforms import widgetsapp = Flask(__name__, template_folder='templates')
app.debug = Trueclass LoginForm(Form):user = simple.StringField(label='用户名',validators=[validators.DataRequired(message='用户名不能为空'),validators.Length(min=6, max=18, message=f'用户名长度必须大于{min}且小于{max}')],widget=widgets.TextInput(),render_kw={'class': 'form-control'}    # 设置生成的html标签的属性)pwd = simple.PasswordField(label='密码',validators=[validators.DataRequired(message='密码不能为空'),validators.Length(min=8, message=f'密码必须大于{min}'),# validators.Regexp(regex=r'^(?=.*[A-Z])'  # 至少一个大写字母#                         r'(?=.*[a-z])'  # 至少一个小写字母#                         r'(?=.*\d)'  # 至少一个数字#                         r'(?=.*[@$!%*?&])'  # 至少一个特殊字符#                         r'[A-Za-z\d@$!%*?&]{8,}$',  # 总长度至少8个字符#                   message='密码至少8个字符，至少一个大写字母，一个小写字母，一个数字和一个特殊字符')],widget=widgets.PasswordInput(),render_kw={'class': 'form-control'})@app.route('/login', methods=['GET', 'POST'])
def login():if request.method == 'GET':form = LoginForm()return render_template('login.html', form=form)form = LoginForm(formdata=request.form)if not form.validate():return render_template('login.html', form=form)# 对用户提交数据进行校验，form.data是校验完成后的数据字典if form.data['user'] == '1234567' and form.data['pwd'] == '123456789':print('用户提交的数据通过格式验证，提交的值为：', form.data)return 'Login OK~'else:return render_template('login.html',msg='用户名或密码错误', form=form)if __name__ == '__main__':app.run()

login.html：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>用户登录</title>
</head>
<body>
<form action="" method="post">{{form.user}} {{form.user.errors[0]}}{{form.pwd}} {{form.pwd.errors[0]}}<input type="submit" value="提交">{{msg}}
</form>
</body>
</html>

用户注册验证：

  • 注册页面需要让用户输入：用户名、密码、确认密码、性别、爱好…

来一个实战例子，底下会拆分详讲：

from flask import Flask, render_template, request, redirect
from wtforms import Form
from wtforms.fields import core, simple, html5
from wtforms import validators
from wtforms import widgetsapp = Flask(__name__, template_folder='templates')
app.debug = Trueclass RegisterForm(Form):name = simple.StringField(label='用户名',validators=[validators.DataRequired()],widget=widgets.TextInput(),render_kw={'class': 'form-control'},default='GuHanZhe'                         # 页面输入框默认值)pwd = simple.PasswordField(label='密码',validators=[validators.DataRequired(message='密码不能为空')],widget=widgets.PasswordInput(),render_kw={'class': 'form-control'})pwd_confirm = simple.PasswordField(label='确认密码',validators=[validators.DataRequired(message='确认密码不能为空'),validators.EqualTo('pwd', message='两次密码输入不一致')    # EqualTo作用是比较当前字段和指定字段名的字段值是否相等],widget=widgets.PasswordInput(),render_kw={'class': 'form-control'})email = html5.EmailField(label='邮箱',validators=[validators.DataRequired(message='邮箱不能为空'),validators.Email(message='邮箱格式有误')],widget=widgets.TextInput(input_type='email'),render_kw={'class': 'form-control'})gender = core.RadioField(label='性别',choices=((1, '男'),(2, '女'),),coerce=int)city = core.SelectField(label='城市',choices=(('bj', '北京'),('sh', '上海')))hobby = core.SelectMultipleField(label='爱好',choices=((1, '篮球'),(2, '足球')),coerce=int)favor = core.SelectMultipleField(label='爱好',choices=((1, '篮球'),(2, '足球')),widget=widgets.ListWidget(prefix_label=False),option_widget=widgets.CheckboxInput(),coerce=int,default=[1, 2])def __int__(self, *args, **kwargs):super(RegisterForm, self).__init__(*args, **kwargs)self.favor.choices = ((1, '篮球'), (2, '足球'), (3, '羽毛球'))def validate_pwd_confirm(self, field):"""自定义pwd_confirm字段规则，例：与pwd字段是否一致"""# 最开始初始化时，self.data中已有所有值if field.data != self.data['pwd']:# raise validators.ValidationError('密码不一致')   # 继续后续字段的验证raise validators.StopValidation('密码不一致')      # 不再继续后续字段的验证@app.route('/register', methods=['GET', 'POST'])
def register():if request.method == 'GET':form = RegisterForm(data={'gender': 1})return render_template('register.html', form=form)form = RegisterForm(formdata=request.form)if form.validate():print('用户提交数据通过格式验证，提交的值为：', form.data)else:print(form.errors)return render_template('register.html', form=form)if __name__ == '__main__':app.run()

  1. 有关于上述代码中coerce=int的作用：

    在这里插入图片描述

    在wtforms库中，coerce参数是用来强制转换字段值的参数。coerce=int的作用是将选项中的值强制转换为整数类型。

    在RadioField中，choices参数定义了可选的值，它是一个元组，其中包含了每个选项的值和标签。在上图中，每个选项的值是1和2，而标签是’男’和’女’。由于HTTP表单提交的数据通常是字符串形式，使用coerce=int告诉wtforms将用户提交的值强制转换为整数类型。

    这对于确保表单数据的类型与后端处理代码的期望类型一致非常有用。在这个例子中，gender字段的值将被强制转换为整数，而不是保持为字符串。这样，在处理表单数据时就可以直接使用整数类型，而不需要手动进行类型转换。

  2. 上述我定义了这么多的字段，难道在写前端register.html代码的时候要一个个敲吗？？？

    肯定不是的！

    wtforms支持我们使用for循环~

    回想一下：一个类的实例如何才能支持for循环？

    在《Python全栈系列教程》专栏里讲过，只要一个类内部实现了iter魔法方法，且这个方法返回了一个迭代器，那么这个类的实例就支持for循环。

    在这里插入图片描述

    所以来看下wtforms源码，确认一下：

    进Form —> 进BaseForm：

    在这里插入图片描述

使用示例：

from flask import Flask, render_template, request, redirect
from wtforms import Form
from wtforms.fields import core, simple, html5
from wtforms import validators
from wtforms import widgetsapp = Flask(__name__, template_folder='templates')
app.debug = Trueclass RegisterForm(Form):name = simple.StringField(label='用户名',validators=[validators.DataRequired()],widget=widgets.TextInput(),render_kw={'class': 'form-control'},default='GuHanZhe'                         # 页面输入框默认值)pwd = simple.PasswordField(label='密码',validators=[validators.DataRequired(message='密码不能为空')],widget=widgets.PasswordInput(),render_kw={'class': 'form-control'})pwd_confirm = simple.PasswordField(label='确认密码',validators=[validators.DataRequired(message='确认密码不能为空'),validators.EqualTo('pwd', message='两次密码输入不一致')    # EqualTo作用是比较当前字段和指定字段名的字段值是否相等],widget=widgets.PasswordInput(),render_kw={'class': 'form-control'})email = html5.EmailField(label='邮箱',validators=[validators.DataRequired(message='邮箱不能为空'),validators.Email(message='邮箱格式有误')],widget=widgets.TextInput(input_type='email'),render_kw={'class': 'form-control'})gender = core.RadioField(label='性别',choices=((1, '男'),(2, '女'),),coerce=int)city = core.SelectField(label='城市',choices=(('bj', '北京'),('sh', '上海')))hobby = core.SelectMultipleField(label='爱好',choices=((1, '篮球'),(2, '足球')),coerce=int)favor = core.SelectMultipleField(label='爱好',choices=((1, '篮球'),(2, '足球')),widget=widgets.ListWidget(prefix_label=False),option_widget=widgets.CheckboxInput(),coerce=int,default=[1, 2])@app.route('/register', methods=['GET', 'POST'])
def register():if request.method == 'GET':form = RegisterForm()return render_template('register.html', form=form)form = RegisterForm(formdata=request.form)if form.validate():print('用户提交数据通过格式验证，提交的值为：', form.data)else:print(form.errors)return '登录成功~'if __name__ == '__main__':app.run()

register.html：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>用户注册</title>
</head>
<body>
<form action="" method="post">{% for item in form %}<p>{{ item.label }}: {{item}} {{item.errors[0]}}</p>{% endfor %}<input type="submit" value="提交">
</form>
</body>
</html>

  • 问题引入：

    实际生产中，可能有些下拉框的值是从数据库中取出展示的。此处以city这个为例：

        city = core.SelectField(label='城市',choices=SQLHelper.fetch_all('select id, name from city_info', {}))

    如果直接运行访问，这个下拉框是没有任何问题的。

    但是实际生产中可能会遇到的一个问题是：Flask服务没关，但是往数据库这张表加了几条数据，那么，不管怎样刷新页面，这个下拉框都不会出现这些新加的数据。

    但是将Flask服务重启一下就OK 了。

    原因很简单——因为在RegisterForm类中这些字段都是静态字段，运行的时候只执行一次！

  • 解决方法就是：

    重写RegisterForm类的构造方法：让每次实例化这个类的时候都执行一次sql查询语句并更新对应字段值：

        def __int__(self, *args, **kwargs):super(RegisterForm, self).__init__(*args, **kwargs)self.city.choices = SQLHelper.fetch_all('select id, name from city_info', {})

如何自定义校验规则：

【方法名以validate_开头，后面是对应需要校验的字段名】

    def validate_pwd_confirm(self, field):"""自定义pwd_confirm字段规则，例：与pwd字段是否一致"""# 最开始初始化时，self.data中已有所有值# field.data就是当前字段的值if field.data != self.data['pwd']:# raise validators.ValidationError('密码不一致')   # 继续后续字段的验证raise validators.StopValidation('密码不一致')      # 不再继续后续字段的验证

抽象解读使用wtforms编写的类：

简单谈一嘴：

比如LoginForm类中的user字段，很容易知道user是一个实例（可以点进去StringField发现它是一个类）：

在这里插入图片描述

在视图函数中，实例化form后将其传给了前端：

在这里插入图片描述

而前端就相当于执行了print(form.user)

那么这就执行对应类StringField的str魔法方法，这个玩意返回什么，页面就看到什么~

开始抽象：

class LoginForm(Form):user = 类（正则， 插件）字段 = 类（正则， 插件）字段 = 类（正则， 插件）字段 = 类（正则， 插件）form = LoginForm(Form)
# 生成html标签
print(form.user)   ——>   类.__str__   ——>   插件.xx方法# 验证
form = LoginForm(formdata=request.form)
if form.validate():# 内部找到所有的字段：#                  比如：user + 用户发过来的对应的数据   ——>    正则校验

http://www.ppmy.cn/news/1423253.html

相关文章

利用FFmpeg 转换课程vtt 字幕到 srt字幕

利用FFmpeg 转换课程vtt 字幕到 srt字幕

字幕转换工具 经常学习udemy 视频课程的&#xff0c;可能知道&#xff0c;从网络下载的udemy 课程文件里面有时候字幕是vtt 格式的&#xff0c;有时候想导入到百度网盘里面&#xff0c;怎奈百度网盘&#xff0c;不支持vtt 字幕格式。有字幕的时候&#xff0c;会比较好多了。既可…
阅读更多...
windows11 wsl2 ubuntu20.04安装vision mamba并进行测试

windows11 wsl2 ubuntu20.04安装vision mamba并进行测试

windows11 wsl2 ubuntu20.04安装vision mamba 安装流程使用cifar-100测试安装成功 安装流程 vision mamba安装了半天才跑通&#xff0c;记录一下流程在wsl上安装cuda wget https://developer.download.nvidia.cn/compute/cuda/11.8.0/local_installers/cuda_11.8.0_520.61.05…
阅读更多...
AI大模型

AI大模型

工欲善其事必先利其器 软件开发也要与时俱进&#xff0c;了解下AI大模型的工具 上点黑科技干货 开整 ~ 背景介绍 天工AI通义灵码KIMI 通义灵码 免费&#xff0c;功能强大 通义灵码&#xff0c;是阿里云出品的一款基于通义大模型的智能编码辅助工具&#xff0c;提供行级/函数…
阅读更多...
管理能力学习笔记五：识别团队角色，因才施用

管理能力学习笔记五：识别团队角色，因才施用

识别团队角色&#xff0c;因才施用&#xff0c;需要做到以下三点 扬长避短 管理者要学会问自己员工能把什么做好&#xff0c;而不是想方设法改造他们的短处 。 – 彼得德鲁克 人岗匹配 将合适的人放在合适的位置 人才多样化 团队需要各式各样的人才&#xff0c;才能高效配合…
阅读更多...
中仕公考：2024年广东省高校毕业生‘三支一扶‘公告

中仕公考：2024年广东省高校毕业生‘三支一扶‘公告

2024年广东省三支一扶共计划招募3000名左右高校毕业生&#xff0c;服务期限为两年&#xff0c;具体招募岗位和条件可通过广东人事考试网查询。 招考条件&#xff1a; 年龄不超过30周岁(1993年4月22日后出生); 支教岗位须是已取得教师资格证的高校毕业生&#xff0c;支医专业…
阅读更多...
pyqt实现星三角减压启动

pyqt实现星三角减压启动

这个对于plc上实现是非常容易得。它本来就是逻辑控制器&#xff0c;如果用代码实现它&#xff0c;该怎么做呢&#xff1f;这个实现起来看似简单&#xff0c;实则是有不少坑的&#xff08;大神除外&#xff09;。我一直想用类来封装&#xff0c;让它继承QObject,为啥非要继承QOb…
阅读更多...
零基础如何学习linux知识

零基础如何学习linux知识

零基础学习Linux需要一个结构化和逐步深入的学习计划。以下是一个学习方向和框架仅供参考&#xff1a; 一&#xff0c; 学习方向 1. **了解Linux基础**&#xff1a; - 理解开源概念。 - 了解Linux的历史和它的重要性。 - 认识不同的Linux发行版。 2. **命令行操作*…
阅读更多...
吐血整理！跨境电商全年选品方向！一年12个月热点解析

吐血整理！跨境电商全年选品方向！一年12个月热点解析

一月 演出服、礼盒、贺卡、装饰品、彩带、拉花、红地毯、邀请函、荧光棒、泡泡机等。 二月 超级碗&#xff1a;投影仪、蓝牙音箱、超级碗电子游戏、望远镜、运动类产品等&#xff1b; 情人节&#xff1a;珠宝、服饰饰品、巧克力、香水、口红、烘焙用品、礼盒、个人护理、成…
阅读更多...
最新文章

Copyright @ 2022~2023