一、表单
表单在页面中主要负责数据采集,一个表单有三个基本组成部分:
- 表单标签:这里面包含了处理表单数据所用CGI程序的URL以及数据提交到服务器的方法。
- 表单域:包含了文本框密码框、隐藏域多行文本框、复选框单选框下拉选择框和文件上传框等。
- 表单按钮:包括提交按钮、复位按钮和一般按钮;用于将数据传送到服务器上的CGI脚本或者取消输入,还可以用表单按钮来控制其他定义了处理脚本的处理工作
常见的表单有注册表单、登录表单、搜索表单等
视图函数中获取表单数据的方式有两种:
- GET请求提交的表单:request.args.get('name', None)
- POST请求提交的表单:request.from.get('age', None)
二、WTF表单
WTF 表单是一个第三方的库,可以通过Python代码生成表单,而Flask-WTF则是Flask集成了WTF表单功能的实现。
Flask-WTF可以实现这些功能,
- 集成 wtforms。
- 带有 csrf 令牌的安全表单。
- 全局的 csrf 保护。
- 支持验证码(Recaptcha)。
- 与 Flask-Uploads 一起支持文件上传。
- 国际化集成。
更多信息可以查看 Flask-WTF 官网。Flask-WTF需要通过安装才可以使用。
代码语言:javascript复制pip3 install Flask-WTF
在Pycharm中创建新的Flask项目flask-wtf,要使用Flask-WTF需要在app.py中创建Flask对象之后添加如下配置,
代码语言:javascript复制# 配置WTF的CSRF,Value可以是任意的字符串
app.config['WTF_CSRF_SECRET_KEY'] = 'abc21231fafae2'
第一个表单模型
在项目目录下新建一个form.py文件,专门用来编写表单模型,以登录表单为例,新增一个LoginForm对象,并增加相应的属性
代码语言:javascript复制from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField
class LoginForm(FlaskForm):
username = StringField(label='用户名')
password = PasswordField(label='密码')
submit = SubmitField(label='提交')
表单字段的常用核心属性如下
属性名 | 属性作用 |
---|---|
label | form表单中的label标签,如输入框前的文字描述 |
default | 表单中输入框的默认值 |
validators | 表单验证规则 |
widget | 定制界面的显示方式 |
description | 帮助文字 |
在app.py中增加视图函数
代码语言:javascript复制from flask import Flask, render_template
from form import LoginForm
@app.route('/form')
def form():
login_form = LoginForm()
# 返回login_form表单模型,在form.html中进行渲染
return render_template('form.html', login_form=login_form)
在templates增加form.html
代码语言:javascript复制<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<title>Form</title>
</head>
<body>
<h3>登录</h3>
<form action="">
{# 渲染LoginForm表单模型中username字段的label属性#}
{{ login_form.username.label }}:
{{ login_form.username }} <br>
{{ login_form.password.label }}:
{{ login_form.password }} <br>
{{ login_form.submit }}
</form>
</body>
</html>
启动应用,浏览器访问 http://127.0.0.1:5000/form
表单渲染成功,但是input输入框是空白的,可以通过表单模型中字段的default属性来设置默认值
代码语言:javascript复制# 其余代码不变
class LoginForm(FlaskForm):
username = StringField(label='用户名', default='stark')
password = PasswordField(label='密码', default='1231231')
submit = SubmitField(label='提交')
再次访问 http://127.0.0.1:5000/form
用户名字段类型是StringField并且显示了设置的默认值,密码是PasswordField类型,虽然设置了默认值,但是是不能显示的。在表单中的用户名和密码输入框中输入数据
可以看出密码是非明文显示的
表单模型的字段类型
在第一个表单模型中使用了两个字段类型,分别是StringField和PasswordField,并且在页面输入密码是也能够将密码以非明文的形式显示,除了这两个类型外还有其他的字段类型,
- 文本/字符串相关类型
- StringField,字符串输入
- PasswordField,密码输入
- TextAreaField,长文本输入
- HiddenField,隐藏表单域
- 数值类型既整数和小数相关类型
- FloadField,浮点数输入
- IntegerField,整数输入
- DecimalField,精确小数输入
- 单选多选等选择相关类型
- RadioField,radio单选
- SelectField,下拉单选
- SelectMultipleField,下拉多选
- BooleanField,勾选
- 日期时间相关类型
- DateField,日期选择
- DateTimeField,日期时间选择
- 文件上传相关类型
- FileField,文件单选
- MultipleFileField,文件多选
- 其他类型
- SubmitField,提交表单按钮
- FieldList,自定义的表单选择列表
- FormField,自定义多个字段构成的选项