day 66 form组件、forms组件的钩子函数

 forms组件

需求示例：获取用户输入 后端判断用户输入的内容是否合法，如果不合法前端渲染对应的错误信息

传统：

def register(request):
    back_dic = {'username': '', 'password': ""}
    if request.method == 'POST':
        username = request.POST.get('username')
        pwd = request.POST.get('password')
        if '666' in username:
            res = "不能有666"
            back_dic['username'] = res
        if pwd == "123":
            res = "密码太简单"
            back_dic['password'] = res
    return render(request, 'reg.html', locals())
View Code

 html:

</head>
<body>
<form action="" method="post">
{% csrf_token %}
    <p><input type="text" name="username">
        <span>{{ back_dic.username }}</span>
    </p>
    <p><input type="text" name="password">
        <span>{{ back_dic.password }}</span>
    </p>
    <input type="submit">
    </form>
</body>
</html>
View Code

用forms组件来实现：校验数据、渲染页面、展示提示信息

一、校验数据、【前后端都可以校验数据，前端可以没有，但是后端一定要有】　

　　1.校验数据，需要一个类，继承forms.Form

from django import forms

class Myform(forms.Form):
    username = forms.CharField(max_length=8)
    password = forms.CharField(max_length=6, min_length=3)
    email = forms.EmailField()
View Code

　　2. 给forms组件传参数（字典的形式）　

　　　　obj = views.Myform({'username': 'egion', 'passowrod': '123'})

　　3.查看数据校验结果

　　　　obj.is_valid()   

　　4. 查看干净的数据

　　　obj.cleaned_data    ==> 正确的以字典形式放入{'username': 'egondsb2', 'password': '123'}

　　5. 查看不正确的数据

　　　obj.errors    ==> 错误的放入{'password': ['Ensure this value has at least 3 characters (it has 2).'],

　　　　　　　　　　　　　　　　'email': ['This field is required.']}

from app01 import views
obj = views.Myform({"username":"egondsb", "password": "123"})
obj.is_valid()
False
obj.cleaned_data
{'password': '123'}
obj.errors
{'username': ['Ensure this value has at most 6 characters (it has 7).'], 'email': ['This field is required.']}
View Code

 　　ps: forms组件中所有的字段默认都是必填的（不能为空）

　　　　在数据都满足forms组件校验规则的情况下，多传的数据不作校验，

 补充：正则校验数据 

from  django.core.validators import RegexValidator
phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), 
                                    RegexValidator(r'^159[0-9]+$', '必须以159开头')])

RegexValidator验证器

from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
 
class MyForm(Form):
    user = fields.CharField(
        validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
    )
View Code

自定义验证函数

 View Code

二. 渲染页面、 forms组件只能帮你渲染  获取用户输入（输入框 、选择框 、下拉框 。。。） 提交按钮也得自己写

　　前端页面识别到是forms组件时，也会校验数据长度，

　　form表单取消前端校验的提示信息：<form action="/reg1/" method="post" novalidate>

 　  initial  初始值， input框里面的初始值

　　views:

def reg1(request):
    form_obj = Myform()
    return render(request, 'reg1.html', locals())
View Code

　　1.第一种渲染页面的方式【扩展性不高，本地测试】  as_p 、|     as_ul  

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post">
    {% csrf_token %}
    <p>forms第一种渲染标签的方式</p>
{#    {{ form_obj.as_p }} p标签包裹着#}
    {{ form_obj.as_ul }}  li标签包裹着
{#lable展示的信息默认情况下是字段名首字母大写#}

</form>
</body>
</html>
View Code

　　

　　2. 第二种，输入框与label名需自己写，缺点是，当字段比较多时，需要一个个的写，麻烦！包裹p标签

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post">
    <p>forms第二种渲染标签的方式</p>
    <p>
        {{ form_obj.username.label }}{{ form_obj.username }} {# forms对象点字段名拿到的是对应的输入框 #}
    </p>
    <p>
        {{ form_obj.password.label }}{{ form_obj.password }} {# forms对象点字段名拿到的是对应的输入框 #}
    </p>
    
</form>
View Code

　　

　　3.第三种，常用方式

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title</title>
</head>
<body>
<form action="" method="post" novalidate>
    {% csrf_token %}
    {% for foo in form_obj %}
        <p>{{ foo.label }}{{ foo }}
        <span>{{ foo.errors.0 }}</span>
        </p>
    {% endfor %}
    <input type="submit">
</form>
</body>
</html>
View Code

     

Django Form所有内置字段

Field
    required=True,               是否允许为空
    widget=None,                 HTML插件
    label=None,                  用于生成Label标签或显示内容
    initial=None,                初始值
    help_text='',                帮助信息(在标签旁边显示)
    error_messages=None,         错误信息 {'required': '不能为空', 'invalid': '格式错误'}
    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)
    ...                        django.forms.models.ModelChoiceField
    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类型
View Code

三.展示信息

　1. label名，错误息信, 密码密文【from django.forms import widgets】，等可以在类中先定义

from django import forms
from django.forms import widgets
class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={"required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={"class": "form-control c1"}),
                               error_messages={"required": "邮箱不能为空", "invalid": "邮箱格式不正确"})
    email = forms.EmailField()
View Code

choice字段、 多选checkbox、单选select、radioSelect、password

class Myform2(forms.Form):
    gender = forms.fields.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性别",
        initial=3,
        widget=forms.widgets.RadioSelect()
    )

    hobby = forms.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple()
    )

    keep = forms.ChoiceField(
        label="是否记住密码",
        initial="checked",
        widget=forms.widgets.CheckboxInput()
    )
    hobby1 = forms.ChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=3,
        widget=forms.widgets.Select()
    )
    username = forms.CharField(
        min_length=8,
        label="用户名",
        initial="张三",
        error_messages={
            "required": "不能为空",
            "invalid": "格式错误",
            "min_length": "用户名最短8位"
        }
    )


def reg2(request):
    myform2 = Myform2()
    if request.method == "POST":
        myform2 = Myform2(request.POST)
        if myform2.is_valid():
            print(myform2.cleaned_data)
    return render(request, "reg2.html", locals())
View Code

在django中测试脚本：

1.新建一个test文件：

import os
import sys

if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "day66ajaxformdata.settings")
    import django
    django.setup()

    # 将要测试的代码导入
    from app01 import models
    print(models.Userinfo.objects.all())
View Code
import os
import sys

if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "day66ajaxformdata.settings")
    import django
    django.setup()

    # 将要测试的代码导入
    # from app01 import models
    # print(models.Userinfo.objects.all())

    from app01 import views
    obj = views.Myform({'username': "egon", "password": '123'})
    print(obj.is_valid())
View Code

2. python console 中测试，直接导入需要测试的文件，下面以测试上面forms组件为例

　　python Console中

from app01 import views
obj = views.Myform({"username":"egondsb", "password": "123"})
obj.is_valid()   # 校验数据结果
False
obj.cleaned_data
{'password': '123'}
obj.errors
{'username': ['Ensure this value has at most 6 characters (it has 7).'], 'email': ['This field is required.']}
View Code

forms组件的钩子函数 Hook方法【在form类中写钩子函数】

数据校验顺序：先校验字段中的条件，再走钩子函数规则

局部钩子【校验单个字段】 : 在用户名中不能有666字样

from django import forms
from django.forms import widgets
from  django.core.validators import RegexValidator

class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={"required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={"class": "form-control c1"}),
                               error_messages={"required": "邮箱不能为空", "invalid": "邮箱格式不正确"})
    email = forms.EmailField()

    phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'),
                                        RegexValidator(r'^159[0-9]+$', '必须以159开头')])

    def clean_username(self):
        # 用户名不能有666
        username = self.cleaned_data.get('username')
        if "666" in username:
            self.add_error('username', '光喊666是不行的')
            return username
View Code

全局钩子【校验多个字段】：两次密码需一致

from django import forms
from django.forms import widgets
from  django.core.validators import RegexValidator

class Myform(forms.Form):
    username = forms.CharField(max_length=8, label="用户名", initial="张三", error_messages={"required": "用户名不能为空",
                                                                          "max_length": "用户名长度不能超过8位"})
    password = forms.CharField(max_length=6, min_length=3,
                               widget=forms.widgets.PasswordInput(attrs={"class": "form-control c1"}),)


    confirm_password = forms.CharField(max_length=8, min_length=3, label="确认密码",
                                       widget=forms.widgets.PasswordInput(attrs={"class": "form-control c1"}))


    email = forms.EmailField(error_messages={"required": "邮箱不能为空", "invalid": "邮箱格式不正确"})

    phone = forms.CharField(validators=[RegexValidator(r'^[0-9]+$', '请输入数字'),
                                        RegexValidator(r'^159[0-9]+$', '必须以159开头')])

    def clean_username(self):
        # 用户名不能有666
        username = self.cleaned_data.get('username')
        if "666" in username:
            self.add_error('username', '光喊666是不行的')
            return username

    def clean(self):
        password = self.cleaned_data.get('password')
        confirm_password = self.cleaned_data.get('confirm_password')
        if password != confirm_password:
            self.add_error("confirm_password", "两次密码不一致")
            return self.cleaned_data
View Code
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/qingqinxu/p/11226097.html