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),
]

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>



# novalidate 取消浏览器自动校验

效果

补充:

为什么数据校验非要去后端 不能在前端利用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>

第二种渲染方式

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()
    # 2 直接将该空对象传递给html页面
    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>
 <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>
</body>
</html>

补充:

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

效果:

第三种渲染方式

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()
    # 2 直接将该空对象传递给html页面
    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>
<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>
</body>
</html>

效果:

渲染标签总结:

"""
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),
]

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>

# novalidate 取消浏览器自动校验

发现错误信息是以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),
]

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 # 设置默认值
invalid # 邮箱格式不正确required # 控制字段是否必填
widget # 控制type类型及属性

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

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

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>

效果

其他类型渲染

# 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())
文档更新时间: 2022-03-10 10:06   作者:李延召