Web表单
web表单是web应用程序的基本功能。
它是HTML页面中负责数据采集的部件。表单有三个部分组成:表单标签、表单域、表单按钮。表单允许用户输入数据,负责HTML页面数据采集,通过表单将用户输入的数据提交给服务器。
在Flask中,为了处理web表单,我们一般使用Flask-WTF扩展,它封装了WTForms,并且它有验证表单数据的功能
WTForms支持的HTML标准字段
字段对象 | 说明 |
---|---|
StringField | 文本字段 |
TextAreaField | 多行文本字段 |
PasswordField | 密码文本字段 |
HiddenField | 隐藏文件字段 |
DateField | 文本字段,值为 datetime.date 文本格式 |
DateTimeField | 文本字段,值为 datetime.datetime 文本格式 |
IntegerField | 文本字段,值为整数 |
DecimalField | 文本字段,值为decimal.Decimal |
FloatField | 文本字段,值为浮点数 |
BooleanField | 复选框,值为True 和 False |
RadioField | 一组单选框 |
SelectField | 下拉列表 |
SelectMutipleField | 下拉列表,可选择多个值 |
FileField | 文件上传字段 |
SubmitField | 表单提交按钮 |
FormField | 把表单作为字段嵌入另一个表单 |
FieldList | 一组指定类型的字段 |
WTForms常用验证函数
验证函数 | 说明 |
---|---|
DataRequired | 确保字段中有数据 |
EqualTo | 比较两个字段的值,常用于比较两次密码输入 |
Length | 验证输入的字符串长度 |
NumberRange | 验证输入的值在数字范围内 |
URL | 验证URL |
AnyOf | 验证输入值在可选列表中 |
NoneOf | 验证输入值不在可选列表中 |
使用Flask-WTF需要配置参数SECRET_KEY。
CSRF_ENABLED是为了CSRF(跨站请求伪造)保护。 SECRET_KEY用来生成加密令牌,当CSRF激活的时候,该设置会根据设置的密匙生成加密令牌。在HTML页面中直接写form表单:
示例
使用普通方式实现表单
在HTML页面中直接写form表单:
创建一个templates文件夹,在里面新建一个wtf.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>普通方式实现表单</title>
</head>
<body>
<form method="post">
<label>用户名:</label><input type="text" name="username"><br>
<label>密码:</label><input type="password" name="password"><br>
<label>确认密码:</label><input type="password" name="password2"><br>
<input type="submit" value="提交"><br>
{% for message in get_flashed_messages() %}
{{ message }}
{% endfor %}
</form>
</body>
</html>
视图函数中获取表单数据:
在templates文件夹外(同目录)新建一个wtf.py
from flask import Flask,render_template,request
app = Flask(__name__)
app.secret_key='heima'
@app.route('/',methods=['GET','POST'])
def helloworld():
# 1 判断请求方法是否为POST
if request.method=='POST':
# 2 获取参数 并校验参数完整性,如果有问题进行flash
username=request.form.get('username')
password=request.form.get('password')
password2 = request.form.get('password2')
# 验证数据是否完整
if not all([username,password,password2]):
return '数据不完整'
# 校验密码是否相同
if password != password2:
return '两次密码不一致'
# 没有问题返回success
else:
return 'success'
return render_template('wtf.html')
if __name__=='__main__':
app.run()
使用Flask-WTF实现表单
模板页面:
创建一个templates文件夹,在里面新建一个Flask_WTF.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Flask_WTF表单</title>
</head>
<body>
<form method="post">
{#设置csrf_token#}
{{ form.csrf_token() }}
{{ form.username.label }}{{ form.username }}<br>
{{ form.password.label }}{{ form.password }}<br>
{{ form.password2.label }}{{ form.password2 }}<br>
{{ form.input }}<br>
</form>
</body>
</html>
视图函数:
在templates文件夹外(同目录)新建一个Flask_WTF.py
from flask import Flask,render_template,request,flash
# 导入wtf的表单类
from flask_wtf import FlaskForm
# 导入自定义表单需要的字段
from wtforms import SubmitField,StringField,PasswordField
# 导入wtf扩展提供的表单验证器
from wtforms.validators import DataRequired,EqualTo
app=Flask(__name__)
app.config['SECRET_KEY']='heima'
# 自定义表单类,文本字段,密码字段,提交按钮
# 需要自定义一个表单类
class RegisterForm(FlaskForm):
username=StringField('用户名:',validators=[DataRequired()])
password=PasswordField('密码:',validators=[DataRequired()])
password2=PasswordField('确认密码:',validators=[DataRequired(),EqualTo('password','两次密码输入不一致')])
input=SubmitField('提交')
# 定义根路由视图函数,生成表单对象,获取表单数据,进行表单数据验证
@app.route('/form',methods=['GET','POST'])
def form():
register_form=RegisterForm()
if request.method=='POST':
#调用validate_on_submit方法 可以一次性执行所有的验证函数的逻辑
if register_form.validate_on_submit():
#进入这里就表示所有的逻辑都验证成功
username=request.form.get('username')
password=request.form.get('password')
password2=request.form.get('password2')
return 'success'
else:
return '参数有误'
return render_template('Flask_WTF.html',form=register_form)
# 自定义一个欢迎界面
@app.route('/')
def welcome():
return '欢迎界面'
if __name__=='__main__':
app.run()