2.8.5Django --11 Django的forms组件

Django目录：https://www.jianshu.com/p/dc36f62b3dc5

什么是forms组件

forms组件就是django内置的一个类，来弥补form表单的功能，例如提供校验数据，渲染表单，页面显示错误等功能。

接着我们就通过一个简单的登录注册例子来讲解forms组件。

简单例子

他需要完成四个功能：
1.校验数据
2.页面显示错误信息
3.渲染页面
4.重置输入

校验规则如下：
用户名不能低于五个字。
密码必须是纯数字。
邮箱必须符合邮箱格式。
错误返回给用户。

formsDemo.formsDemo.urls.py
---------------------------
from django.contrib import admin
from django.urls import path
from app01 import views
urlpatterns = [
    path('admin/', admin.site.urls),
    path('register/',views.register)
]

formsDemo.app01.models.py
-------------------------
from django.db import models

# Create your models here.
class UserInfo(models.Model):
    name=models.CharField(max_length=32)
    pwd=models.IntegerField()
    email=models.EmailField()

formsDemo.app01.views.py
------------------------
from django.shortcuts import render,HttpResponse
from app01.models import UserInfo

#使用forms进行校验的话，必须设置一个forms的类用来定义规则。
from django import forms
class UserForm(forms.Form):
    #自定义报错信息
    msg={'required':'该字段不能为空'}
    #设置name长度不能超过5.
    name=forms.CharField(max_length=5,error_messages=msg)
    #设置密码只能是纯数字.
    pwd=forms.IntegerField()
    email=forms.EmailField(error_messages={"invalid":"邮箱格式不正确"})

def register(request):

    if request.method=="POST":
        form=UserForm(request.POST)
        # is_valid  用来校验数据是否合法
        if form.is_valid():
            print(form.cleaned_data)       # 所有干净的字段以及对应的值
            #将合法数据写入数据库
            UserInfo.objects.create(**form.cleaned_data)
            #返回ok
            return HttpResponse("OK")
        else:
            # cleaned_data输出不合法数据  errors输出字段错误信息
            print(form.cleaned_data)       #
            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}
            print(form.errors.get("name")) # ErrorList ["错误信息",]
            # 获取错误
            error = form.errors
            #将错误返回给模板
            return render(request, "register.html", locals())
    else:
        return render(request,'register.html')

formsDemo.templates.register.html
---------------------------------



    
    
    




    {% csrf_token %}
    

        用户名
        
{{ error.name.0 }}
    
    

        密码
        
{{ error.pwd.0 }}
    
     

        邮箱
        
{{ error.email.0 }}
    
    

页面截图

校验规则1-1

校验规则1-2

校验规则2-1

校验规则2-2

校验规则3-1

校验规则3-2

一条正确的数据

提交成功的页面

现在我们的例子完成了 1 和 2 两个功能，还有渲染页面和重置数据没有完成。我么现在的页面有四个input标签，可以一个一个手打，但是如果有十个，二十个呢，我们怎么自己生产form表单，这就是渲染页面的功能。 同时如果我们表单有一项填错了，后台会自动返回新的页面，我们刚才填的数据就没了，这就是很没有用户体验的事情。

渲染页面方式1

formsDemo.app01.views.py
------------------------
def register(request):  
    if request.method=="POST":
        form = UserForm(request.POST)
        # is_valid  用来校验数据是否合法
        if form.is_valid():
            print(form.cleaned_data)       # 所有干净的字段以及对应的值
            #将合法数据写入数据库
            UserInfo.objects.create(**form.cleaned_data)
            #返回ok
            return HttpResponse("OK")
        else:
            # cleaned_data输出不合法数据  errors输出字段错误信息
            print(form.cleaned_data)       #
            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}
            print(form.errors.get("name")) # ErrorList ["错误信息",]
            # 获取错误
            error = form.errors
            #将错误返回给模板
            return render(request, "register.html", locals())

    else:
        form = UserForm()
        return render(request,'register.html',locals())

formsDemo.templates.register.html
---------------------------------



    
    




    {% csrf_token %}
    {{form.as_p}}
    

渲染页面1

渲染代码

渲染页面方式2：

formsDemo.templates.register.html
---------------------------------



    
    




    {% csrf_token %}
    
用户名 {{ form.name }}{{ error.name.0 }}
    
密码 {{ form.pwd }}{{ error.pwd.0 }}
    
邮箱 {{ form.email }}{{ error.email.0 }}
    

渲染页面

渲染代码

Django渲染标签报错，浏览器就会拦截。
不过后台该校验就校验。

小惊喜

取消前端校验

{#novalidate#}

    {% csrf_token %}
    
用户名 {{ form.name }}{{ error.name.0 }}
    
密码 {{ form.pwd }}{{ error.pwd.0 }}
    
邮箱 {{ form.email }}{{ error.email.0 }}
    

取消校验

我们刚才输错信息会重置输入信息功能的功能也解决了。

真正的惊喜

这是因为，咱们的错误信息是使用form表单渲染的，而数据也是用form表单来渲染的。

渲染页面方式3：

formsDemo.app01.views.py
-----------------------
class UserForm(forms.Form):
    #自定义报错信息
    msg={'required':'该字段不能为空'}
    #设置name长度不能超过5.
    #label设置别名。
    name=forms.CharField(max_length=5,error_messages=msg,label='用户名')
    #设置密码只能是纯数字.
    pwd=forms.IntegerField(label='密码')
    email=forms.EmailField(error_messages={"invalid":"邮箱格式不正确"},label='邮箱')

formsDemo.templates.register.html
---------------------------------

    {% csrf_token %}
    {% for field in form %}
        

            {{ field.label }}
            {{ field }}{{ field.errors.0 }}
        
    {% endfor %}
    

渲染页面

渲染代码