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

- 日理万妓 2021-09-30 14:52 395阅读 0赞

** forms组件**

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

传统：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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())

html:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

</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>

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

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

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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()

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.'\]\}

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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.']}

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

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

补充：正则校验数据

from  django.core.validators import RegexValidator

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

### RegexValidator验证器 ###

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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开头')],
        )

### 自定义验证函数 ###

![ContractedBlock.gif][]

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

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

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

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

views:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

<!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>

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

<!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>

3.第三种，常用方式

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

<!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>

Django Form所有内置字段

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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类型

三.展示信息

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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()

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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())

在django中测试脚本：

1.新建一个test文件：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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())

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

python Console中

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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.']}

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

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

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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

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

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

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

转载于:https://www.cnblogs.com/qingqinxu/p/11226097.html

[ContractedBlock.gif]: /images/20210724/86936b8da0b843d498b9292a26e8f1fb.png
[ExpandedBlockStart.gif]: /images/20210724/0c8439d0d30a414aa576d5bd7b1fa9a6.png