一、校验字段功能
通过注册用户这个实例来学习校验字段功能。
1、模型:models.py
from django.db import models # Create your models here. class UserInfo(models.Model): name = models.CharField(max_length=32) pwd = models.CharField(max_length=32) email = models.EmailField() tel = models.CharField(max_length=32)
修改配置后,完成数据库迁移操作,可以查看到UserInfo表已经创建完成。
2、模板:reg.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="" method="post"> {% csrf_token %} <p>用户名<input type="text" name="name"></p> <p>密码<input type="text" name="pwd"></p> <p>确认密码<input type="text" name="r_pwd"></p> <p>邮箱<input type="text" name="email"></p> <p>手机号<input type="text" name="tel"></p> <input type="submit"> </form> </body> </html>
3、视图函数:views.py
from django.shortcuts import render,HttpResponse # Create your views here. from django import forms # 引入forms组件 class UserForm(forms.Form): # 必须继承forms.Form name = forms.CharField(min_length=4) pwd = forms.CharField(min_length=4) r_pwd = forms.CharField(min_length=4) email = forms.EmailField() tel = forms.CharField() def reg(request): if request.method=="POST": print(request.POST) # 生成forms对象后,传入字典就可以做一个个值的校验 # form = UserForm({"name": "yuan", "email": "[email protected]", "xxx":"alex"}) form = UserForm(request.POST) # form表单的name属性值应该与forms组件的字段名称一致,不一致的键值不会去做校验 print(form.is_valid()) # 返回True/False # 帮忙校验 if form.is_valid(): # 注意:form.is_valid是帮忙校验返回布尔值的,true或false(所有都通过才返回true) # 类定义的字段均符合要求,返回true,有多的字段直接忽略 print(form.cleaned_data) # {'name': 'yuan', 'pwd': '1234', 'r_pwd': '1234', 'email': '[email protected]', 'tel': '123123'} else: # 有正确也有错误信息也是返回false print(form.cleaned_data) # 字段值符合要求的放在cleaned_data {'name': 'yuan', 'pwd': '123456', 'tel': '123123'} print(form.errors) # 字段不符合要求的对应的键作为键,错误信息作为值 <ul class="errorlist"><li>r_pwd<ul class="errorlist">... print(type(form.errors)) # <class 'django.forms.utils.ErrorDict'> 还是一个字段类型 print(form.errors.get("r_pwd")) # <ul class="errorlist"><li>This field is required.</li></ul> print(type(form.errors.get("r_pwd"))) # <class 'django.forms.utils.ErrorList'> 用列表存放错误信息 print(form.errors.get("r_pwd")[0]) # 获取到报错信息:This field is required. """ form.is_valid() 校验返回布尔值 if 所有的字段校验成功,则form.cleaned_data:{"name": "yuan", "email": "[email protected]"} 如果校验失败,则form.errors放入所有错误的字段。 """ return HttpResponse("OK") return render(request, "reg.html")
注意:
(1)引入forms组件,定义的类必须继承forms.Form,forms类定义过的属性默认非空。
from django import forms # 引入forms组件 class UserForm(forms.Form): # 必须继承forms.Form name = forms.CharField(min_length=4) pwd = forms.CharField(min_length=4) r_pwd = forms.CharField(min_length=4) email = forms.EmailField() tel = forms.CharField()
(2)生成forms对象,需要注意的是给对象传入字典就可以做一个个值的校验:
form = UserForm({"name": "yuan", "email": "[email protected]", "xxx":"alex"})
但是我们需要的是form表单属性与forms组件字段的校验,因此需要把request.POST传入forms对象:
form = UserForm(request.POST)
form表单的name属性值应该与forms组件的字段名称一致,不一致的键值不会去做校验。
(3)form.is_valid() :做校验返回布尔值的,所有都通过才返回True,否则返回False。与forms组件字段无关的键值不影响返回结果。
if form.is_valid(): # 注意:form.is_valid是帮忙校验返回布尔值的,true或false(所有都通过才返回true) # 类定义的字段均符合要求,返回true,有多的字段直接忽略 print(form.cleaned_data) # {'name': 'yuan', 'pwd': '1234', 'r_pwd': '1234', 'email': '[email protected]', 'tel': '123123'} else: # 有正确也有错误信息也是返回false print(form.cleaned_data) # 字段值符合要求的放在cleaned_data {'name': 'yuan', 'pwd': '123456', 'tel': '123123'} print(form.errors) # 字段不符合要求的对应的键作为键,错误信息作为值 <ul class="errorlist"><li>r_pwd<ul class="errorlist">...
(4)form.cleaned_data:字段值符合要求的放在cleaned_data中。字典数据类型。
(5)form.errors:字段不符合要求的对应的键作为键,错误信息作为值。虽然返回结果比较复杂,但依然是字典数据类型,可以通过form.errors.get(“不符合的键”)来拿到键值,键值为列表数据类型。因此可以通过form.errors.get("不符合键")[0]拿到错误信息。
二、渲染标签功能
1、渲染方式一:
视图函数:将forms空对象传给模板
from django import forms # 引入forms组件 class UserForm(forms.Form): # 必须继承forms.Form # forms.CharField和forms.EmailField会渲染为input标签 name = forms.CharField(min_length=4) # 默认label是字段名 pwd = forms.CharField(min_length=4, label="密码") # 如果需要中文label可以手动设置 r_pwd = forms.CharField(min_length=4, label="确认密码") email = forms.EmailField(label="邮箱") tel = forms.CharField(label="手机") def reg(request): form = UserForm() return render(request, "reg.html", locals())
模板:
<h3>form组件渲染方式1</h3> <form action="" method="post"> {% csrf_token %} <p>{{ form.name.label }} {{ form.name }} </p> <p>{{ form.pwd.label }} {{ form.pwd }} </p> <p>{{ form.r_pwd.label }} {{ form.r_pwd }} </p> <p>{{ form.email.label }} {{ form.email }} </p> <p>{{ form.tel.label }} {{ form.tel }} </p> <input type="submit"> </form>
渲染效果:
2、渲染方式二
其他与方式一同理,但是用for循环获取forms对象内字段。
<h3>forms组件渲染方式2</h3> <form action="" method="post"> {% csrf_token %} {% for field in form %} <p> <label for="">{{ field.label }}</label> {{ field }} </p> {% endfor %} <input type="submit"> </form>
渲染效果:
3、渲染方式三
调用form对象的组件:as_p,即完成渲染。缺点是结构固定。(还有一种是as_ul)
<hr> <h3>forms组件渲染方式3</h3> <form action="" method="post"> {% csrf_token %} {{ form.as_p }} </form>
渲染效果: