• Django之forms组件


    froms组件前戏

    需求:

    """
    写一个注册功能
        获取用户名和密码 利用form表单提交数据
        在后端判断用户名和密码是否符合一定的条件
            用户名中不能含有666
            密码不能少于三位
        
        如何符合条件需要你将提示信息展示到前端页面
    """

    普通方式实现(不结合ajax)

    views.py

    from django.shortcuts import render
    
    # Create your views here.
    
    def ab_form(request):
        back_dic = {"username":"","password":""}
        if request.method == "POST":
            username = request.POST.get("username")
            password = request.POST.get("password")
            if "666" in username:
                back_dic["username"] = "*用户名不合法"
            if len(password) < 3:
                back_dic["password"] = "*密码长度小于3"
    
        return render(request,"ab_form.html",locals())
        """
        无论是post请求还是get请求
        页面都能够获取到字典 只不过get请求来的时候 字典值都是空的
        而post请求来之后 字典可能有值
        """

    ab_form.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- Bootstrap3 核心 CSS 文件 -->
        <link href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
        <!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
        <script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
        <!-- Bootstrap3 核心 JavaScript 文件 -->
        <script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
        <!-- font-awesome.min.css图标库4.7版本 -->
        <link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">
    </head>
    <body>
        <div class="container-fluid">
          <div class="row">
                <div class="col-md-8 col-md-offset-2">
                    <form action="" method="post">
                        <p>username:
                            <input type="text" class="form-control" name="username">
                            <span style="color: red">{{ back_dic.username }}</span>
                        </p>
                        <p>password:
                            <input type="text" class="form-control" name="password">
                            <span style="color: red">{{ back_dic.password }}</span>
                        </p>
                        <input type="submit" class="btn btn-info btn-block">
                    </form>
                </div>
          </div>
        </div>
    </body>
    </html>

    效果:

     使用到的技术点

    # 1.手动书写前端获取用户数据的html代码                        渲染html代码
    # 2.后端对用户数据进行校验                                   校验数据
    # 3.对不符合要求的数据进行前端提示                            展示提示信息

    forms组件实现

    forms组件能够完成的事情:

    # 1.渲染html代码
    # 2.校验数据
    # 3.展示提示信息

    urls.py

    from django.conf.urls import url
    from django.contrib import admin
    from app01 import views
    
    urlpatterns = [
        url(r'^admin/', admin.site.urls),
        # forms组件
        url(r'^ab_form/', views.ab_form),
    ]
    urls.py

    views.py,本文forms是直接写在views.py中的,也可以在app01应用中单独建一个文件夹或py文件解耦合,然后再views.py中导入

    from django.shortcuts import render,HttpResponse
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名",
                                   error_messages={
                                       'min_length':'用户名最少3位',
                                       'max_length':'用户名最大8位',
                                       'required':"用户名不能为空"
                                   }
                                   )
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码",
                                    error_messages = {
                                        'min_length': '密码最少3位',
                                        'max_length': '密码最大8位',
                                        'required': "密码不能为空"
                                    }
                                    )
    
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱",
                                 error_messages={
                                     'invalid': '邮箱格式不正确',
                                     'required': "邮箱不能为空"
                                 }
                                 )
    
        # 钩子函数
        # 局部钩子
        def clean_username(self):    # 用来校验username,走这一步前提是上面username字段条件满足了
            # 获取到用户名
            username = self.cleaned_data.get("username")
            if '666' in username:
                # 提示前端展示报错信息
                self.add_error("username","用户名不合法")      # 添加一个错误信息,第一个参数是给哪个字段增加错误信息,第二个参数是错误信息内容
            # 将钩子函数钩取到的数据再放回去
            return username
    
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        if request.method == "POST":
            # 获取用户数据
            """
            1.数据获取繁琐
            2.校验数据需要构造成字典的格式传入才行
            ps:但是request.POST可以看成就是一个字典
            """
            # 3.校验数据
            form_obj = MyForms(request.POST)
            # 4.判断数据是否合法
            if form_obj.is_valid():
                # 5.如果合法 操作数据库存储数据
                return HttpResponse('OK')
            # 5.不合法 有错误
        return render(request,"ab_form.html",locals())

    ab_form.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- Bootstrap3 核心 CSS 文件 -->
        <link href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
        <!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
        <script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
        <!-- Bootstrap3 核心 JavaScript 文件 -->
        <script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
        <!-- font-awesome.min.css图标库4.7版本 -->
        <link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">
    </head>
    <body>
        <div class="container-fluid">
          <div class="row">
                <div class="col-md-8 col-md-offset-2">
                    <form action="" method="post" novalidate>
                        {% for form in form_obj %}
                            <p>
                                {{ form.label }}:{{ form }}
                                <span style="color: red">{{ form.errors.0 }}</span>
                            </p>
                        {% endfor %}
                        <input type="submit" class="btn btn-info">
                    </form>
                </div>
          </div>
        </div>
    </body>
    </html>

    效果

    补充:

    为什么数据校验非要去后端 不能在前端利用js直接完成呢?
        数据校验前端可有可无
        但是后端必须要有!!!
        
        因为前端的校验是弱不禁风的 你可以直接修改
        或者利用爬虫程序绕过前端页面直接朝后端提交数据
        
        购物网站    
            选取了货物之后 会计算一个价格发送给后端 如果后端不做价格的校验
            
            实际是获取到用户选择的所有商品的主键值
            然后在后端查询出所有商品的价格 再次计算一遍
            如果跟前端一致 那么完成支付如果不一致直接拒绝

    forms组件基本使用

    from django.shortcuts import render
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3)
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3)
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField()

    froms组件校验数据

    """
    1.测试环境的准备 可以自己拷贝代码准备
    2.其实在pycharm里面已经帮你准备一个测试环境
        python console
    """

    在python console操作示例:

    from app01 import views
    # 1 将带校验的数据组织成字典的形式传入即可
    form_obj = views.MyForm({'username':'jason','password':'123','email':'123'})
    # 2 判断数据是否合法        注意该方法只有在所有的数据全部合法的情况下才会返回True
    form_obj.is_valid()
    False
    # 3 查看所有校验通过的数据
    form_obj.cleaned_data
    {'username': 'jason', 'password': '123'}
    # 4 查看所有不符合校验规则以及不符合的原因
    form_obj.errors
    {
      'email': ['Enter a valid email address.']
    }
    # 5 校验数据只校验类中出现的字段 多传不影响 多传的字段直接忽略
    form_obj = views.MyForm({'username':'jason','password':'123','email':'123@qq.com','hobby':'study'})
    form_obj.is_valid()
    True
    # 6 校验数据 默认情况下 类里面所有的字段都必须传值
    form_obj = views.MyForm({'username':'jason','password':'123'})
    form_obj.is_valid()
    False
    """
    也就意味着校验数据的时候 默认情况下数据可以多传但是绝不可能少传
    """

    forms渲染标签

    """
    forms组件只会自动帮你渲染获取用户输入的标签(input select radio checkbox)
    不能帮你渲染提交按钮
    """

    三种渲染方式:

    views.py

    from django.shortcuts import render,HttpResponse
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3)
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3)
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField()
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        # 2 直接将该空对象传递给html页面
        return render(request,"ab_form.html",locals())

    ab_form.html,前端利用空对象做操作

    第一种渲染方式:

    <form action="" method="post">
        <p>第一种渲染方式:代码书写极少,封装程度太高 不便于后续的扩展 一般情况下只在本地测试使用</p>
        {{ form_obj.as_p }}
        {{ form_obj.as_ul }}
        {{ form_obj.as_table }}
        <input type="submit" class="btn btn-info btn-block">
    </form>

     第二种渲染方式:

     <form action="" method="post">
        <p>第二种渲染方式:可扩展性很强 但是需要书写的代码太多  一般情况下不用</p>      
        <!--form_obj.username(forms类中的字段名):会帮你渲染一个name属性值为username(那个类中字段名)的input框-->
        <!--form_obj.username.label:拿到标签注释-->
        <p>{{ form_obj.username.label }}:{{ form_obj.username }}</p>
        <p>{{ form_obj.password.label }}:{{ form_obj.password }}</p>
        <p>{{ form_obj.email.label }}:{{ form_obj.email }}</p>
        <input type="submit" class="btn btn-info btn-block">
    </form>

    补充:

    """
    label属性默认展示的是类中定义的字段首字母大写的形式
    也可以自己修改 直接给forms类中字段对象加label属性即可
         username = forms.CharField(min_length=3,max_length=8,label='用户名')
    """

    示例:

    from django.shortcuts import render,HttpResponse
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名")
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码")
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱")
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        # 2 直接将该空对象传递给html页面
        return render(request,"ab_form.html",locals())
    字段添加label属性

    效果:

     第三种渲染方式

    <form action="" method="post">
        <p>第三种渲染方式(推荐使用):代码书写简单 并且扩展性也高</p>
        {% for form in form_obj %}
    <!--此时的form等价于form_obj.username-->
    <p>{{ form.label }}:{{ form }}</p> {% endfor %} <input type="submit" class="btn btn-info btn-block"> </form>

    效果:

    渲染标签总结:

    """
    forms组件只会自动帮你渲染获取用户输入的标签(input select radio checkbox)
    不能帮你渲染提交按钮
    """
    def index(request):
        # 1 先产生一个空对象
        form_obj = MyForm()
        # 2 直接将该空对象传递给html页面
        return render(request,'index.html',locals())
    
    # 前端利用空对象做操作
        <p>第一种渲染方式:代码书写极少,封装程度太高 不便于后续的扩展 一般情况下只在本地测试使用</p>
        {{ form_obj.as_p }}
        {{ form_obj.as_ul }}
        {{ form_obj.as_table }}
        <p>第二种渲染方式:可扩展性很强 但是需要书写的代码太多  一般情况下不用</p>
        <p>{{ form_obj.username.label }}:{{ form_obj.username }}</p>
        <p>{{ form_obj.password.label }}:{{ form_obj.password }}</p>
        <p>{{ form_obj.email.label }}:{{ form_obj.email }}</p>
        <p>第三种渲染方式(推荐使用):代码书写简单 并且扩展性也高</p>
        {% for form in form_obj %}
            <p>{{ form.label }}:{{ form }}</p>
        {% endfor %}
     
    """
    字段的label属性默认展示的是类中定义的字段首字母大写的形式
    也可以自己修改 直接给字段对象加label属性即可
         username = forms.CharField(min_length=3,max_length=8,label='用户名')
    """

    补充:可以通过auto_id获取forms渲染的input框的id

                    {% for form in form_obj %}
                        <div class="from-group">
                            <!--form.auto_id获取forms渲染的input框的id-->
                            <label for="{{ form.auto_id }}">{{ form.label }}</label>
                            {{ form }}
                            <span style="color: red" class="pull-right"></span>
                        </div>
                    {% endfor %}        

    forms展示提示信息

    示例:

    urls.py

    from django.conf.urls import url
    from django.contrib import admin
    from app01 import views
    
    urlpatterns = [
        url(r'^admin/', admin.site.urls),
        # forms组件
        url(r'^ab_form/', views.ab_form),
    ]
    urls.py

    views.py

    from django.shortcuts import render,HttpResponse
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名")
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码")
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱")
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        if request.method == "POST":
            # 获取用户数据
            """
            1.数据获取繁琐
            2.校验数据需要构造成字典的格式传入才行
            ps:但是request.POST可以看成就是一个字典
            """
            # 3.校验数据
            form_obj = MyForms(request.POST)   # 注意这里变量名一定要和产生的空对象的变量名一致
            # 4.判断数据是否合法
            if form_obj.is_valid():
                # 5.如果合法 操作数据库存储数据
                return HttpResponse('OK')
            # 5.不合法 在前端通过forms对象errors结合errors展示错误信息
        return render(request,"ab_form.html",locals())

    注意:

    """
    1.必备的条件 get请求和post传给html页面对象变量名必须一样
    2.forms组件当你的数据不合法的情况下 会保存你上次的数据 让你基于之前的结果进行修改
    更加的人性化
    """

    ab_form.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- Bootstrap3 核心 CSS 文件 -->
        <link href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
        <!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
        <script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
        <!-- Bootstrap3 核心 JavaScript 文件 -->
        <script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
        <!-- font-awesome.min.css图标库4.7版本 -->
        <link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">
    </head>
    <body>
        <div class="container-fluid">
          <div class="row">
                <div class="col-md-8 col-md-offset-2">
                    <form action="" method="post" novalidate>
                        {% for form in form_obj %}
                            <p>
                                {{ form.label }}:{{ form }}
                                <span style="color: red">{{ form.errors }}</span>
                            </p>
                        {% endfor %}
                        <input type="submit" class="btn btn-info">
                    </form>
                </div>
          </div>
        </div>
    </body>
    </html>

    浏览器输入不符合校验的数据

     注意:这个提示信息是浏览器自动帮你校验的

    """
    浏览器会自动帮你校验数据 但是前端的校验弱不禁风
    如何让浏览器不做校验
        <form action="" method="post" novalidate>
    """

    关闭浏览器自动校验以及注意事项

    <form action="" method="post" novalidate>
        {% for form in form_obj %}
            <p>
                {{ form.label }}:{{ form }}
                <span style="color: red">{{ form.errors }}</span>
            </p>
        {% endfor %}
        <input type="submit" class="btn btn-info">
    </form>

    发现错误信息是以li标签展示的

     标准姿势:form.errors.0:只拿列表第一个错误信息

    <form action="" method="post" novalidate>
        {% for form in form_obj %}
            <p>
                {{ form.label }}:{{ form }}
                <span style="color: red">{{ form.errors.0 }}</span>
            </p>
        {% endfor %}
        <input type="submit" class="btn btn-info">
    </form>

    错误提示信息默认为英文,可以自定义,看下面自定义错误提示信息。

     自定义错误提示信息

    字段的添加error_messages={"错误条件":"错误信息","错误条件":"错误信息"...}

    # 针对错误的提示信息还可以自己自定制
    class MyForm(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(min_length=3,max_length=8,label='用户名',
                                   error_messages={
                                       'min_length':'用户名最少3位',
                                       'max_length':'用户名最大8位',
                                       'required':"用户名不能为空"
                                   }
                                   )
        # password字符串类型最小3位最大8位
        password = forms.CharField(min_length=3,max_length=8,label='密码',
                                   error_messages={
                                       'min_length': '密码最少3位',
                                       'max_length': '密码最大8位',
                                       'required': "密码不能为空"
                                   }
                                   )
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label='邮箱',
                                 error_messages={
                                     'invalid':'邮箱格式不正确',
                                     'required': "邮箱不能为空"
                                 }
                                 )

     forms组件钩子函数(HOOK)

    """
    在特定的节点自动触发完成响应操作
    
    钩子函数在forms组件中就类似于第二道关卡,能够让我们自定义校验规则
    
    在forms组件中有两类钩子
        1.局部钩子
            当你需要给单个字段增加校验规则的时候可以使用
        2.全局钩子
          当你需要给多个字段增加校验规则的时候可以使用
    """

    实际案例

    需求:

    # 1.校验用户名中不能含有666                只是校验username字段  局部钩子
    
    # 2.校验密码和确认密码是否一致            password confirm两个字段    全局钩子

    urls.py

    from django.conf.urls import url
    from django.contrib import admin
    from app01 import views
    
    urlpatterns = [
        url(r'^admin/', admin.site.urls),
        # forms组件
        url(r'^ab_form/', views.ab_form),
    ]
    urls.py

    views.py

    from django.shortcuts import render,HttpResponse
    
    # 基本使用
    from django import forms      # forms组件所需模块
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名",
                                   error_messages={
                                       'min_length':'用户名最少3位',
                                       'max_length':'用户名最大8位',
                                       'required':"用户名不能为空"
                                   }
                                   )
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码",
                                    error_messages = {
                                        'min_length': '密码最少3位',
                                        'max_length': '密码最大8位',
                                        'required': "密码不能为空"
                                    }
                                    )
    
        re_password = forms.CharField(max_length=8, min_length=3, label="确认密码",
                                   error_messages={
                                       'min_length': '确认密码最少3位',
                                       'max_length': '确认密码最大8位',
                                       'required': "确认密码不能为空"
                                   }
                                   )
    
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱",
                                 error_messages={
                                     'invalid': '邮箱格式不正确',
                                     'required': "邮箱不能为空"
                                 }
                                 )
    
        # 钩子函数
        # 局部钩子
        def clean_username(self):    # 用来校验username,走这一步前提是上面username字段条件满足了
            # 获取到用户名
            username = self.cleaned_data.get("username")
            if '666' in username:
                # 提示前端展示报错信息
                self.add_error("username","用户名不合法")      # 添加一个错误信息,第一个参数是给哪个字段增加错误信息,第二个参数是错误信息内容
            # 将钩子函数钩取到的数据再放回去
            return username
    
        # 全局钩子
        def clean(self):    # 全局钩子
            password = self.cleaned_data.get("password")
            re_password = self.cleaned_data.get("re_password")
            if not password == re_password:
                self.add_error("re_password","两次密码不一致")
    
            # 将钩子函数钩取的数据返回
            return self.cleaned_data
    
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        if request.method == "POST":
            # 获取用户数据
            """
            1.数据获取繁琐
            2.校验数据需要构造成字典的格式传入才行
            ps:但是request.POST可以看成就是一个字典
            """
            # 3.校验数据
            form_obj = MyForms(request.POST)
            # 4.判断数据是否合法
            if form_obj.is_valid():
                # 5.如果合法 操作数据库存储数据
                return HttpResponse('OK')
            # 5.不合法 有错误
        return render(request,"ab_form.html",locals())

    ab_form.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- Bootstrap3 核心 CSS 文件 -->
        <link href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
        <!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
        <script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
        <!-- Bootstrap3 核心 JavaScript 文件 -->
        <script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
        <!-- font-awesome.min.css图标库4.7版本 -->
        <link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">
    </head>
    <body>
        <div class="container-fluid">
          <div class="row">
                <div class="col-md-8 col-md-offset-2">
                    <form action="" method="post" novalidate>
                        {% for form in form_obj %}
                            <p>
                                {{ form.label }}:{{ form }}
                                <span style="color: red">{{ form.errors.0 }}</span>
                            </p>
                        {% endfor %}
                        <input type="submit" class="btn btn-info">
                    </form>
                </div>
          </div>
        </div>
    </body>
    </html>

    效果:

     forms组件字段的其他参数及补充知识点

    forms类中常见字段

    max_length # 允许输入的最大长度
    min_length # 最小长度
    label # input的提示信息,name、password等
    error_messages # 自定义报错的提示信息
    initial # 设置默认值
    required # 控制字段是否必填
    widget # 控制type类型及属性

    字段样式以及正则参数:

    """
    1.字段没有样式
    2.针对不同类型的input如何修改
        text
        password
        date
        radio
        checkbox
        ...
    """
    
    # 可以通过为字段添加wiget参数进行设置,属性多个值用空格隔开
    widget=forms.widgets.标签类型(attrs={'class':'form-control c1 c2'})   
    # 多个属性值的话 直接空格隔开即可
    
    # 字段里面还有支持正则校验的参数,注意要导入正则匹配的组件
    from django.core.validators import RegexValidator   # 导入正则匹配组件
    validators=[
                RegexValidator(r'^[0-9]+$', '请输入数字'),
                RegexValidator(r'^159[0-9]+$', '数字必须以159开头')
            ]

    案例:提示报错信息时,文本框也会变红

    views.py

    from django.shortcuts import render,HttpResponse
    from app01 import models
    
    # 基本使用
    from django import forms      # forms组件所需模块
    from django.core.validators import RegexValidator  # 导入正则匹配的组件
    
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名",
                                   error_messages={
                                       'min_length':'用户名最少3位',
                                       'max_length':'用户名最大8位',
                                       'required':"用户名不能为空"
                                   },
                                   widget=forms.widgets.TextInput(attrs={'class':'form-control'})
                                   )
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码",
                                    error_messages = {
                                        'min_length': '密码最少3位',
                                        'max_length': '密码最大8位',
                                        'required': "密码不能为空"
                                    },
                                   widget=forms.widgets.PasswordInput(attrs={'class':'form-control'})
                                    )
    
        re_password = forms.CharField(max_length=8, min_length=3, label="确认密码",
                                   error_messages={
                                       'min_length': '确认密码最少3位',
                                       'max_length': '确认密码最大8位',
                                       'required': "确认密码不能为空"
                                   },
                                   widget=forms.widgets.PasswordInput(attrs={'class':'form-control'})
                                   )
        phone =forms.CharField(max_length=11, min_length=11, label="手机号",
                                   error_messages={
                                       'min_length': '手机号最少11位',
                                       'max_length': '手机号最大11位',
                                       'required': "手机号不能为空"
                                   },
                                   widget=forms.widgets.TextInput(attrs={'class':'form-control'}),
                                   validators=[
                                       RegexValidator(r'^[0-9]+$', '请输入数字'),
                                       RegexValidator(r'^159[0-9]+$', '数字必须以159开头')
                                   ]
                                   )
    
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱",
                                 error_messages={
                                     'invalid': '邮箱格式不正确',
                                     'required': "邮箱不能为空"
                                 },
                                 widget=forms.widgets.EmailInput(attrs={'class':'form-control'})
                                 )
    
        # 钩子函数
        # 局部钩子
        def clean_username(self):    # 用来校验username,走这一步前提是上面username字段条件满足了
    
            # 获取到用户名
            username = self.cleaned_data.get("username")
            # 判断用户是否存在
            user_obj = models.User.objects.filter(username=username).first()
            if user_obj:
                self.add_error("username","用户已存在")
            # if '666' in username:
                # 提示前端展示报错信息
                # 方法一:add_error()
                # self.add_error("username","用户名不合法")      # 添加一个错误信息,第一个参数是给哪个字段增加错误信息,第二个参数是错误信息内容
                # 方法二:主动抛出异常raise 需要导入ValidationError,      from django.core.exceptions import ValidationError
                # raise ValidationError("用户名不合法")
            # 将钩子函数钩取到的数据再放回去
            return username
    
        # 全局钩子
        def clean(self):    # 全局钩子
            password = self.cleaned_data.get("password")
            re_password = self.cleaned_data.get("re_password")
            if not password == re_password:
                self.add_error("re_password","两次密码不一致")
    
            # 将钩子函数钩取的数据返回
            return self.cleaned_data
    
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        if request.method == "POST":
            # 获取用户数据
            """
            1.数据获取繁琐
            2.校验数据需要构造成字典的格式传入才行
            ps:但是request.POST可以看成就是一个字典
            """
            # 3.校验数据
            form_obj = MyForms(request.POST)
            # 4.判断数据是否合法
            if form_obj.is_valid():
                # 5.如果合法 操作数据库存储数据
                return HttpResponse('OK')
            # 5.不合法 有错误
        return render(request,"ab_form.html",locals())
    views.py

    ab_form.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- Bootstrap3 核心 CSS 文件 -->
        <link href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
        <!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
        <script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
        <!-- Bootstrap3 核心 JavaScript 文件 -->
        <script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
        <!-- font-awesome.min.css图标库4.7版本 -->
        <link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">
    
    </head>
    <body>
        <div class="container-fluid">
          <div class="row">
                <div class="col-md-8 col-md-offset-2">
                    <form action="" method="post" novalidate>
                        {% for form in form_obj %}
                            <p>
                                {{ form.label }}:{{ form }}
                                <span style="color: red" class="input_span">{{ form.errors.0 }}</span>
                            </p>
                        {% endfor %}
                        <p>
                            性别:<input type="radio" name="gender" value="1" checked><input type="radio" name="gender" value="2"><input type="radio" name="gender" value="3"> 保密
                        </p>
                        <input type="submit" class="btn btn-info btn-block" id="btn">
                    </form>
                </div>
          </div>
        </div>
        <script>
            $("p span").each(function(){
            if($(this).text()){
                 $(this).prev().css("border","solid red")
            }
          });
        </script>
    </body>
    </html>
    ab_form.html

    效果

    其他类型渲染

        # radio  单选按钮
        gender = forms.ChoiceField(
            choices=((1, ""), (2, ""), (3, "保密")),
            label="性别",
            initial=3,
            widget=forms.widgets.RadioSelect()
        )
        # select
        hobby = forms.ChoiceField(
            choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
            label="爱好",
            initial=3,
            widget=forms.widgets.Select()
        )
        # 多选
        hobby1 = forms.MultipleChoiceField(
            choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
            label="爱好",
            initial=[1, 3],
            widget=forms.widgets.SelectMultiple()
        )
        # 单选checkbox
        keep = forms.ChoiceField(
            label="是否记住密码",
            initial="checked",
            widget=forms.widgets.CheckboxInput()
        )
        # 多选checkbox
        hobby2 = forms.MultipleChoiceField(
            choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
            label="爱好",
            initial=[1, 3],
            widget=forms.widgets.CheckboxSelectMultiple()
        )

     forms组件源码

    """
    切入点:
        form_obj.is_valid()
    """
    def is_valid(self):
            """
            Returns True if the form has no errors. Otherwise, False. If errors are
            being ignored, returns False.
            """
       return self.is_bound and not self.errors
       # 如果is_valid要返回True的话 那么self.is_bound要为True self.errors要为Flase
      
      
    self.is_bound = data is not None or files is not None  # 只要你传值了肯定为True
    
    
    @property
    def errors(self):
            "Returns an ErrorDict for the data provided for the form"
            if self._errors is None:
                self.full_clean()
            return self._errors
    
    # forms组件所有的功能基本都出自于该方法
    def full_clean(self):
          self._clean_fields()  # 校验字段 + 局部钩子
        self._clean_form()  # 全局钩子
        self._post_clean()  

    源码大体执行流程

    # forms组件源码执行流程
      form.is_valid()----》内部起了一个for循环,先去校验每个字段配置的规则,校验完成,走该字段的局部钩子函数,一个一个执行完(交验完)---》会走全局钩子(clean())--->self就会有clean_data和errors
        
        1 流程:
        1 form.is_valid()
        2 self.errors
        3 self.full_clean()
        4   self._clean_fields()   局部字段的校验(自己的和局部钩子)
                    if hasattr(self, 'clean_%s' % name):
                        func=getattr(self, 'clean_%s' % name)
                        value = func()
                        self.cleaned_data[name] = value
            self._clean_form()     全局的钩子
            self._post_clean()

    看源码知道使用钩子函数要提示前端展示报错信息还有一种通过raise主动抛出一次的方法(针对局部钩子):不过不推荐

    示例:(看局部钩子函数部分)

    views.py

    from django.shortcuts import render,HttpResponse
    from django.core.exceptions import ValidationError
    
    # 基本使用
    from django import forms      # forms组件所需模块
    from django.core.validators import RegexValidator  # 导入正则匹配的组件
    
    
    class MyForms(forms.Form):
        # username字符串类型最小3位最大8位
        username = forms.CharField(max_length=8,min_length=3,label="用户名",
                                   error_messages={
                                       'min_length':'用户名最少3位',
                                       'max_length':'用户名最大8位',
                                       'required':"用户名不能为空"
                                   },
                                   widget=forms.widgets.TextInput(attrs={'class':'form-control'})
                                   )
        # password字符串类型最小3位最大8位
        password = forms.CharField(max_length=8,min_length=3,label="密码",
                                    error_messages = {
                                        'min_length': '密码最少3位',
                                        'max_length': '密码最大8位',
                                        'required': "密码不能为空"
                                    },
                                   widget=forms.widgets.PasswordInput(attrs={'class':'form-control'})
                                    )
    
        re_password = forms.CharField(max_length=8, min_length=3, label="确认密码",
                                   error_messages={
                                       'min_length': '确认密码最少3位',
                                       'max_length': '确认密码最大8位',
                                       'required': "确认密码不能为空"
                                   },
                                   widget=forms.widgets.PasswordInput(attrs={'class':'form-control'})
                                   )
        phone =forms.CharField(max_length=11, min_length=11, label="手机号",
                                   error_messages={
                                       'min_length': '手机号最少11位',
                                       'max_length': '手机号最大11位',
                                       'required': "手机号不能为空"
                                   },
                                   widget=forms.widgets.TextInput(attrs={'class':'form-control'}),
                                   validators=[
                                       RegexValidator(r'^[0-9]+$', '请输入数字'),
                                       RegexValidator(r'^159[0-9]+$', '数字必须以159开头')
                                   ]
                                   )
    
        # email字段必须符合邮箱格式  xxx@xx.com
        email = forms.EmailField(label="邮箱",
                                 error_messages={
                                     'invalid': '邮箱格式不正确',
                                     'required': "邮箱不能为空"
                                 },
                                 widget=forms.widgets.EmailInput(attrs={'class':'form-control'})
                                 )
    
    
        # 钩子函数
        # 局部钩子
        def clean_username(self):    # 用来校验username,走这一步前提是上面username字段条件满足了
    
            # 获取到用户名
            username = self.cleaned_data.get("username")
            if '666' in username:
                # 提示前端展示报错信息
                # 方法一:add_error(),推荐使用
                # self.add_error("username","用户名不合法")      # 添加一个错误信息,第一个参数是给哪个字段增加错误信息,第二个参数是错误信息内容
                # 方法二:(不推荐使用)主动抛出异常raise 需要导入ValidationError,      from django.core.exceptions import ValidationError
                raise ValidationError("用户名不合法")
            # 将钩子函数钩取到的数据再放回去
            return username
    
        # 全局钩子
        def clean(self):    # 全局钩子
            password = self.cleaned_data.get("password")
            re_password = self.cleaned_data.get("re_password")
            if not password == re_password:
                self.add_error("re_password","两次密码不一致")
    
            # 将钩子函数钩取的数据返回
            return self.cleaned_data
    
    
    # 校验数据
    def ab_form(request):
        # 1 先产生一个空对象
        form_obj = MyForms()
        if request.method == "POST":
            # 获取用户数据
            """
            1.数据获取繁琐
            2.校验数据需要构造成字典的格式传入才行
            ps:但是request.POST可以看成就是一个字典
            """
            print(request.POST)
            # 3.校验数据
            form_obj = MyForms(request.POST)
            # 4.判断数据是否合法
            if form_obj.is_valid():
                # 5.如果合法 操作数据库存储数据
                return HttpResponse('OK')
            # 5.不合法 有错误
        return render(request,"ab_form.html",locals())
  • 相关阅读:
    农夫安全第二季课程-3.vmware ESXIv2
    六、表达式:前缀&&后缀
    五、数据类型(1):整数&&带小数点的数
    四、变量和常量
    三、简单的输入输出
    二、第一个C程序:Hello World!
    一、环境的安装Dev-C++
    .Net基础之5——复杂数据类型
    .Net基础之4——流程控制
    .Net基础之3——运算符
  • 原文地址:https://www.cnblogs.com/baicai37/p/13045641.html
Copyright © 2020-2023  润新知