python大佬养成计划----flask应用(表单)

时间 2020-02-10

标签 python 大佬养成计划 flask 应用表单栏目 Python 繁體版

原文原文链接

1. 为何使用Flask-WTF？

request对象公开了全部客户端发送的请求信息。特别是request.form能够访问POST请求提交的表单数据。
尽管Flask的request对象提供的支持足以处理web表单，但依然有许多任务会变得单调且重复。
表单的HTML代码生成和验证提交的表单数据就是两个很好的例子。

优点：html

Flask-WTF扩展使得处理web表单能得到更愉快的体验。该扩展是一个封装了与框架无关的WTForms包的Flask集成。

2. 什么是表单处理?

在网页中，为了和用户进行信息交互老是不得不出现一些表单。
flask设计了WTForm表单库来使flask能够更加简便地管理操做表单数据。
WTForm中最重要的几个概念以下：

1). Form类，开发者自定义的表单必须继承自Form类或者其子类。
Form类最主要的功能是经过其所包含的Field类提供对表单内数据的快捷访问方式。

2). 各类Field类，即字段。通常而言每一个Field类都对应一个input的HTML标签。
好比WTForm自带的一些Field类好比BooleanField就对应<input type="checkbox">，
SubmitField就对应<input type="submit">等等。

3). Validator类。这个类用于验证用户输入的数据的合法性。
好比Length验证器能够用于验证输入数据的长度，
FileAllowed验证上传文件的类型等等。

　　另外，flask为了防范csfr(cross-site request forgery)攻击，默认在使用flask-wtf以前要求app必定要设置过secret_key。最简单地能够经过app.config['SECRET_KEY'] = 'xxxx'来配置。前端

3. 常见的Field类

　　PasswordField　　密码字段，自动将输入转化为小黑点web

　　DateField　　文本字段，格式要求为datetime.date同样正则表达式

　　IntergerField　　文本字段，格式要求是整数flask

　　DecimalField　　文本字段，格式要求和decimal.Decimal同样bootstrap

　　FloatField　　文本字段，值是浮点数app

　　BooleanField　　复选框，值为True或者False框架

　　RadioField　　一组单选框dom

　　SelectField　　下拉列表，须要注意一下的是choices参数肯定了下拉选项，函数

可是和HTML中的<select> 标签同样，其是一个tuple组成的列表，
                   能够认为每一个tuple的第一项是选项的真正的值，而第二项是alias。

　　MultipleSelectField　　可选多个值的下拉列表

Validator验证函数

Validator是验证函数，把一个字段绑定某个验证函数以后，flask会在接收表单中的数据以前对数据作一个验证，
若是验证成功才会接收数据。验证函数Validator以下，具体的validator可能须要的参数不太同样，这里只给出
一些经常使用的，更多详细的用法能够参见wtforms/validators.py文件的源码，参看每个validator类须要哪些参数：

　　*基本上每个validator都有message参数，指出当输入数据不符合validator要求时显示什么信息。

　　Email　　验证电子邮件地址的合法性，要求正则模式是^.+@(¹²+)$

　　EqualTo　　比较两个字段的值，一般用于输入两次密码等场景，可写参数fieldname，不过注意其是一个字符串变量，指向同表单中的另外一个字段的字段名

　　IPAddress　　验证IPv4地址，参数默认ipv4=True,ipv6=False。若是想要验证ipv6能够设置这两个参数反过来。

　　Length　　验证输入的字符串的长度，能够有min,max两个参数指出要设置的长度下限和上限,注意参数类型是字符串，不是INT!!

　　NumberRange　　验证输入数字是否在范围内，能够有min和max两个参数指出数字上限下限，注意参数类型是字符串，不是INT!!而后在这个validator的message参数里能够设置%(min)s和%(max)s两个格式化部分，来告诉前端这个范围究竟是多少。其余validator也有这种相似的小技巧，能够参看源码。

　　Optional　　无输入值时跳过同字段的其余验证函数

　　Required　　必填字段

　　Regexp　　用正则表达式验证值，参数regex='正则模式'

　　URL　　验证URL，要求正则模式是^[a-z]+://(?P<host>³+)(?P<port>:[0-9]+)?(?P<path>/.*)?$

　　AnyOf　　确保值在可选值列表中。参数是values（一个可选值的列表）。特别提下，和SelectField进行配合使用时，不知道为何SelectField的choices中项的值不能是数字。。不然AnyOf的values参数中即便有相关数字也没法识别出当前选项是合法选项。我怀疑NoneOf可能也是同样的套路。

　　NoneOf　　确保值不在可选值列表中

#forms.py文件：用来设定规则
from flask_wtf import FlaskForm
from flask_wtf.file import FileRequired, FileAllowed
from wtforms import StringField, PasswordField, SubmitField, FileField
from wtforms.validators import DataRequired, Length


class LoginForm(FlaskForm):
    name = StringField(
        label="用户名/邮箱/手机号",
        validators=[
            # DataRequired("请输入用户名"),
            Length(3, 20, message="长度不符"),
        ]
    )
    passwd = PasswordField(
        label="密码",
        validators=[
            # DataRequired("请输入密码"),
            Length(3, 20),
        ], )

    file = FileField(
        label="简历",
        validators=[
            FileRequired(),
            FileAllowed(['pdf', 'txt'], 'pdf 能被接收')
        ]
    )

#templates/demo/login.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form method="POST" action="/login/">
    {{ form.hidden_tag() }}
    {{ form.name.label }} {{ form.name }}
    {{ form.passwd.label }} {{ form.passwd }}
    {{ form.file }}
    <input type="submit" value="Go">
</form>

</body>
</html>

#主程序
import random
from flask import Flask, redirect, render_template
from forms import LoginForm
from flask_bootstrap import  Bootstrap

app = Flask(__name__)
bootstrap = Bootstrap(app)
app.config['SECRET_KEY'] =  random._urandom(24)

@app.route('/success/')
def success():
    return  "success"

@app.route('/login/', methods=('GET', 'POST'))
def submit():
    # 实例化表单对象;
    form = LoginForm()
    if form.validate_on_submit():
        print(form.data)
        return redirect('/success/')
    return render_template('demo/login.html', form=form)
app.run()

.@ ↩
@ ↩
/: ↩