python测试开发django-100.Form表单类(forms.Form)

前言

在 HTML 页面中利用 form 表单像后端提交数据，但是很多场景下我们都需要对用户的输入做校验，比如用户是否输入，输入长度以及格式问题。
django 的 Form 表单类可以帮我们快速生成前端 html 代码，也可以校验输入的数据格式。

form 表单

通常情况下，一个登录的表单有输入账号和输入密码2个输入框，可以这样写

<form action="" method="POST" id="login-form" style="text-align:center;">
    {% csrf_token %}
    <p>
        <label for="user">用户名：</label>
        <input  id="user" name="username" type="text" required placeholder="请输入用户名">
    </p>
    <p>
        <label for="psw">密码：</label>
        <input id="psw" name="password" type="password" required placeholder="请输入密码">
    </p>
    <p>
        <input type="submit" value="登录" >
    </p>
</form>

Form表单类(forms.Form)

当form表达的输入项很多的时候，如果一个个去模板写会有很大的工作量，于是可以用到django 的Form表单类来完成

# views.py
from django import forms
# Create your views here.
# 作者-上海悠悠 QQ交流群:717225969
# blog地址 https://www.cnblogs.com/yoyoketang/

class LoginForm(forms.Form):
    """登录Form表单"""
    username = forms.CharField(max_length=32,
                               min_length=3,
                               required=True,
                               label="用户名",
                               )
    password = forms.CharField(max_length=16,
                               min_length=6,
                               required=True,
                               label="密码")

登陆视图函数

from django.shortcuts import render
from django.http import JsonResponse
# 作者-上海悠悠 QQ交流群:717225969
# blog地址 https://www.cnblogs.com/yoyoketang/


def login_form(request):
    if request.method == "GET":
        form_obj = LoginForm()
        return render(request, "demo.html", locals())

    if request.method == "POST":
        form_obj = LoginForm(request.POST)
        if form_obj.is_valid():
            username = form_obj.cleaned_data.get("username")
            password = form_obj.cleaned_data.get("password")
            print("username:", username)
            print("password:", password)
            # 登录认证
            if username == "admin" and password == "123456":
                return JsonResponse({"code": 0, "msg": "login success!"})
            else:
                error_msg = "用户名或密码不正确"
                return render(request, "demo.html", locals())
        else:
            error_msg = form_obj.errors
            return render(request, "demo.html", locals())

模板中form表单格式

<form action="" method="POST" id="login-form" style="text-align:center;">
    {% csrf_token %}

    <p>
        {{ form_obj.username.label }}
        {{ form_obj.username }}
    </p>
    <p>
        {{ form_obj.password.label }}
        {{ form_obj.password }}
    </p>
    <p >
	   {{ error_msg }}
    </p>
    <p>
    <input type="submit" value="登录" >
    </p>
</form>

实现效果

Form 类可使用的字段和参数

Field

参数	说明
required=True,	是否允许为空
widget=None,	HTML插件
label=None,	用于生成Label标签或显示内容
initial=None,	初始值
help_text='',	帮助信息(在标签旁边显示)
error_messages=None,	错误信息 {'required': '不能为空', 'invalid': '格式错误'}
show_hidden_initial=False,	是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直）
validators=[],	自定义验证规则
localize=False,	是否支持本地化
disabled=False,	是否可以编辑
label_suffix=None	Label内容后缀

CharField(Field)

参数	说明
max_length=None,	最大长度
min_length=None,	最小长度
strip=True	是否移除用户输入空白

IntegerField(Field)

参数	说明
max_value=None,	最大值
min_value=None,	最小值

FloatField(IntegerField)
...

DecimalField(IntegerField)

参数	说明
max_value=None,	最大值
min_value=None,	最小值
max_digits=None,	总长度
decimal_places=None,	小数位长度

BaseTemporalField(Field)

参数	说明
input_formats=None	时间格式化

DateField(BaseTemporalField) 格式：2015-09-01
TimeField(BaseTemporalField) 格式：11:12
DateTimeField(BaseTemporalField)格式：2015-09-01 11:12

DurationField(Field) 时间间隔：%d %H:%M:%S.%f
...

RegexField(CharField)

参数	说明
regex,	自定制正则表达式
max_length=None,	最大长度
min_length=None,	最小长度
error_message=None,	忽略，错误信息使用 error_messages={'invalid': '...'}

EmailField(CharField)
...

FileField(Field)

参数	说明
allow_empty_file=False	是否允许空文件

ImageField(FileField)
...
注：需要PIL模块，pip3 install Pillow
以上两个字典使用时，需要注意两点：
- form表单中 enctype="multipart/form-data"
- view函数中 obj = MyForm(request.POST, request.FILES)

URLField(Field)
...

BooleanField(Field)
...

NullBooleanField(BooleanField)
...

ChoiceField(Field)

参数	说明
choices=(),	选项，如：choices = ((0,'上海'),(1,'北京'),)
required=True,	是否必填
widget=None,	插件，默认select插件
label=None,	Label内容
initial=None,	初始值
help_text='',	帮助提示

ModelChoiceField(ChoiceField)

参数	说明
queryset,	查询数据库中的数据
empty_label="---------",	默认空显示内容
to_field_name=None,	HTML中value的值对应的字段
limit_choices_to=None	ModelForm中对queryset二次筛选

ModelMultipleChoiceField(ModelChoiceField)
... django.forms.models.ModelMultipleChoiceField

TypedChoiceField(ChoiceField)

参数	说明
coerce = lambda val: val	对选中的值进行一次转换
empty_value= ''	空值的默认值

MultipleChoiceField(ChoiceField)
...

TypedMultipleChoiceField(MultipleChoiceField)

参数	说明
coerce = lambda val: val	对选中的每一个值进行一次转换
empty_value= ''	空值的默认值

ComboField(Field)

参数	说明
fields=()	使用多个验证，如下：即验证最大长度20，又验证邮箱格式
	fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])

MultiValueField(Field)
PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用

SplitDateTimeField(MultiValueField)

参数	说明
input_date_formats=None,	格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y']
input_time_formats=None	格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M']

FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中

参数	说明
path,	文件夹路径
match=None,	正则匹配
recursive=False,	递归下面的文件夹
allow_files=True,	允许文件
allow_folders=False,	允许文件夹
required=True,
widget=None,
label=None,
initial=None,
help_text=''

GenericIPAddressField

参数	说明
protocol='both',	both,ipv4,ipv6支持的IP格式
unpack_ipv4=False	解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用

SlugField(CharField) 数字，字母，下划线，减号（连字符）
...

UUIDField(CharField) uuid类型