一.安装
pip3 install wtforms
二.简单使用
1.创建flask对象
from flask import Flask,render_template,request,redirect
from wtforms import Form
from wtforms.fields import simple
from wtforms import validators
from wtforms import widgets
app = Flask(__name__,template_folder='templates')
app.debug = True
class LoginForm(Form):
# 字段（内部包含正则表达式）
name = simple.StringField(
label='用户名',#form表单的标签
validators=[ #过滤的一些条件
validators.Datarequired(message='用户名不能为空.'),validators.Length(min=6,max=18,message='用户名长度必须大于%(min)d且小于%(max)d')
],widget=widgets.TextInput(),# 页面上显示的插件
render_kw={'class': 'form-control'} #form表单页面中显示的类名
三.路由
@app.route('/login',methods=['GET','POST'])
def login():
if request.method == 'GET':
form = LoginForm() #生成form对象
return render_template('login.html',form=form) #form对象渲染
else:
form = LoginForm(formdata=request.form)
if form.validate(): #进行form校验
print('用户提交数据通过格式验证，提交的值为：',form.data)
else:
print(form.errors)
return render_template('login.html',form=form)
if __name__ == '__main__':
app.run()
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>登录</h1>
<form method="post">
<p>{{form.name.label}} {{form.name}} {{form.name.errors[0] }}</p>
<p>{{form.pwd.label}} {{form.pwd}} {{form.pwd.errors[0] }}</p>
<input type="submit" value="提交">
</form>
</body>
</html>
1.field字段
WTForms支持HTML字段：
| 字段类型 |
说明 |
| StringField@H_403_50@
| 文本字段， 相当于type类型为text的input标签@H_403_50@
|
| TextAreaField@H_403_50@
| 多行文本字段@H_403_50@
|
| PasswordField@H_403_50@
| 密码文本字段@H_403_50@
|
| HiddenField@H_403_50@
| 隐藏文本字段@H_403_50@
|
| DateField@H_403_50@
| 文本字段， 值为datetime.date格式@H_403_50@
|
| DateTimeField@H_403_50@
| 文本字段， 值为datetime.datetime格式@H_403_50@
|
| IntegerField@H_403_50@
| 文本字段， 值为整数@H_403_50@
|
| DecimalField@H_403_50@
| 文本字段， 值为decimal.Decimal@H_403_50@
|
| FloatField@H_403_50@
| 文本字段， 值为浮点数@H_403_50@
|
| BooleanField@H_403_50@
| 复选框， 值为True 和 False@H_403_50@
|
| RadioField@H_403_50@
| 一组单选框@H_403_50@
|
| SelectField@H_403_50@
| 下拉列表@H_403_50@
|
| SelectMultipleField@H_403_50@
| 下拉列表， 可选择多个值@H_403_50@
|
| FileField@H_403_50@
| 文件上传字段@H_403_50@
|
| SubmitField@H_403_50@
| 表单提交按钮@H_403_50@
|
| FormFiled@H_403_50@
| 把表单作为字段嵌入另一个表单@H_403_50@
|
| FieldList@H_403_50@
| 子组指定类型的字段@H_403_50@
|
2.Validators验证器
WTForms可以支持很多表单的验证函数：
| 验证函数 |
说明 |
| Email@H_403_50@
| 验证是电子邮件地址@H_403_50@
|
| EqualTo@H_403_50@
| 比较两个字段的值； 常用于要求输入两次密钥进行确认的情况@H_403_50@
|
| IPAddress@H_403_50@
| 验证IPv4网络地址@H_403_50@
|
| Length@H_403_50@
| 验证输入字符串的长度@H_403_50@
|
| NumberRange@H_403_50@
| 验证输入的值在数字范围内@H_403_50@
|
| Optional@H_403_50@
| 无输入值时跳过其它验证函数@H_403_50@
|
| Datarequired@H_403_50@
| 确保字段中有数据@H_403_50@
|
| Regexp@H_403_50@
| 使用正则表达式验证输入值@H_403_50@
|
| URL@H_403_50@
| 验证url@H_403_50@
|
| AnyOf@H_403_50@
| 确保输入值在可选值列表中@H_403_50@
|
| NoneOf@H_403_50@
| 确保输入值不在可选列表中@H_403_50@
|
3.字段参数
| 参数名 |
介绍 |
| label@H_403_50@
| 字段别名，在页面中可以通过字段.label展示@H_403_50@
|
| validators@H_403_50@
| 验证规则列表@H_403_50@
|
| filters@H_403_50@
| 过氯器列表，用于对提交数据进行过滤@H_403_50@
|
| description@H_403_50@
| 描述信息，通常用于生成帮助信息@H_403_50@
|
| id@H_403_50@
| 表示在form类定义时候字段的位置，通常你不需要定义它，默认会按照定义的先后顺序排序。@H_403_50@
|
| default@H_403_50@
| 默认值@H_403_50@
|
| widget@H_403_50@
| html插件，通过该插件可以覆盖默认的插件，更多通过用户自定义@H_403_50@
|
| render_kw@H_403_50@
| 自定义html属性@H_403_50@
|
| choices@H_403_50@
| 复选类型的选项@H_403_50@
|
4.局部钩子
#在form类中
def validate_字段名(self,field):
#self.data 获得全局字段的一个类似字典的格式
#self.data['字段'],可以获得全局中任意字段
#field.data 当前字段的值
#无需返回值,如果有不满足的情况需要抛错
#如两个密码,有两种情况
# raise validators.ValidationError("密码不一致") # 继续后续验证
# raise validators.StopValidation("密码不一致") # 不再继续后续验证
5.再不改变模型情况下修改值
#在form类中
def __init__(self,*args,**kwargs):
super(RegisterForm,self).__init__(*args,**kwargs)
self.字段名.choices = ((1,'篮球'),(2,'足球'),(3,'羽毛球'))
四.写好的模板
from flask import Flask,redirect
from wtforms import Form
from wtforms.fields import core
from wtforms.fields import html5
from wtforms.fields import simple
from wtforms import validators
from wtforms import widgets
app = Flask(__name__,template_folder='templates')
app.debug = True
class RegisterForm(Form):
name = simple.StringField(
label='用户名',validators=[
validators.Datarequired()
],render_kw={'class': 'form-control'},default='cxw'
)
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="两次密码输入不一致")
],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,'男'),'女'),),#这句话的意思是上面的choices元组的第一个值是int类型
#如果上上面为(‘1’,(‘2’,则下面的coerce则不用写
coerce=int # “1” “2”
)
#这里是单选框
city = core.SelectField(
label='城市',choices=(
('bj','北京'),('sh','上海'),)
)
#这里是多选框
hobby = core.SelectMultipleField(
label='爱好',coerce=int
)
#这里是多选的checkBox
favor = core.SelectMultipleField(
label='喜好',widget=widgets.ListWidget(prefix_label=False),option_widget=widgets.CheckBoxInput(),coerce=int,default=[1,2]
)
#这里可以改值
def __init__(self,**kwargs)
self.favor.choices = ((1,'羽毛球'))
def validate_pwd_confirm(self,field):
"""
自定义pwd_confirm字段规则，例：与pwd字段是否一致
:param field:
:return:
"""
# 最开始初始化时，self.data中已经有所有的值
if field.data != self.data['pwd']:
# raise validators.ValidationError("密码不一致") # 继续后续验证
raise validators.StopValidation("密码不一致") # 不再继续后续验证
@app.route('/register','POST'])
def register():
if request.method == 'GET':
#这里可以传默认值
form = RegisterForm(data={'gender': 2,'hobby':[1,]}) # initial
return render_template('register.html',form=form)
else:
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()
