Django组件--forms组件（注册用）

一、forms组件--校验类的使用

二、form组件--校验类的参数

三、forms组件校验的局部钩子--自定义校验规则（要看源码理解）

四、forms组件校验的全局钩子--校验form表单两次密码输入是否一致

五、forms组件的渲染标签功能（推荐方式二）

一、forms组件--校验类的使用

1、校验字段功能（最核心功能）

示例1：
在服务端进行格式校验
-------这个写在一个新模块里-------------
from django import forms
class UserForm(forms.Form): #新建一个校验类
　　name = forms.CharField(min_length) #必须为字符串，最小4位
　　email = forms.EmailField() #邮箱校验

--------------------------------------------------

-------视图函数里的用户注册方法-------

def register(request):
　　  # 字典的键必须跟校验类里的字段一样
　　form=UserForm({"name":"yuan","email":"123"})
　　  # 开始校验，所有校验类里的值校验通过返回True，否则返回False
　　  # 字典里有多少个无所谓，只要校验类里的字段通过就是True
　　bool = form.is_valid()
　　  # cleaned_data 这里面放所有校验通过的键值
　　form.cleaned_data
　　  # errors 这里面放所有未通过的键值 是仿字典类型
　　  # 例如name没通过,要取errors里的错误信息：form.errors["name"][0]
　　form.errors

　　return HttpResponse(request, "ok")

------------------------------------------------------

完整示例：

def register(request):
　　  #校验类字段要跟前端form表单一样
　　form=UserForm(request.POST)
　　if form.is_valid():
　　　　clean = form.cleaned_data
　　else:
　　　　clean = form.cleaned_data
　　　　errors = form.errors
-------------------------------------------------
总结：
1.注意前端form表单内的需要校验的属性名称，要跟后端校验类的字段一致
2. 掌握is_valid() 、 cleaned_data、 errors各自含义

二、form组件--校验类的参数

如果想改渲染的标签类型为password：widgets.PasswordInput
如果想改错误提示信息：error_messages参数
如果需要给渲染的标签加样式类, 就要加属性键值对,什么都行：widget=widgets.TextInput(attrs={"class":"form-control"})

from django.forms import widgets
class UserForm(forms.Form): 
　　name = forms.CharField(min_length=4, label="用户名", error_messages={"required":"不能为空","invalid":"格式错误"})  #错误类型不能改其他名字
　　pwd = forms.CharField(min_length=4, label="密码",widget=widgets.PasswordInput(attrs={"class":"form-control"})) 
　　r_pwd = forms.CharField(min_length=4, label="确认密码") 
　　email = forms.EmailField(label="邮箱",widget=widgets.TextInput(attrs={"class":"form-control"}))  # 给标签加属性
　　tel = forms.CharField(label="电话")

三、forms组件校验的局部钩子--自定义校验规则（要看源码理解）

第二层校验:clean_xx方法，校验通过返回该值，否则抛ValidationError异常

------------------------------------------------------------------------------------

from django.core.exceptions import ValidationError
class UserForm(forms.Form): 
　　name = forms.CharField(min_length=4, label="用户名")
　　pwd = forms.CharField(min_length=4, label="密码") 
　　r_pwd = forms.CharField(min_length=4, label="确认密码") 
　　email = forms.EmailField(label="邮箱")
　　tel = forms.CharField(label="电话")

　　#该功能验证用户名是否已被注册
　　def clean_name(self):
　　　　name = self.cleaned_data.get("name")
　　　　ret = UserInfo.objects.filter(name=name)
　　　　if not ret:
　　　　　　return name
　　　　else:
　　　　　　#只能抛这个错误类型
　　　　　　raise ValidationError("该用户已注册")
----------------------------------------------------------------------------------------

四、forms组件校验的全局钩子--校验form表单两次密码输入是否一致

在校验类里，覆盖父类clean方法

获取全局钩子错误(在模板里渲染)：form.errors.get("__all__")[0]

def clean():
　　# 先从cleaned_data中取要联合校验的字段
　　pwd=self.cleaned_data.get('pwd')
　　r_pwd=self.cleaned_data.get('r_pwd')
　　if pwd and r_pwd:
　　　　# pwd跟r_pwd之前的校验已通过，才验证全局钩子
　　　　if pwd==r_pwd:
　　　　　　  # 这里面包括pwd和r_pwd
　　　　　　return self.cleaned_data
　　　　else:
　　　　　　raise ValidationError('两次输入密码不一致')
　　else:
　　　　  # 这里面包括pwd和r_pwd两者之一，或者都不包括
　　　　return self.cleaned_data

五、forms组件的渲染标签功能（推荐方式二）

渲染方式三种、错误信息的渲染方式

1、渲染方式一
先写后端校验类，再在前端渲染，charFiled渲染成input标签：

# 校验类
class UserForm(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):
　　form = UserForm(request.POST)
　　return render("reg_html",{"form":form})

为了方便，Django可以在前端按照后端写的校验类进行渲染
<form>
　　{% csrf_token %}
　　用户名：{{ form.name }}
　　密码：{{ form.pwd }}
　　确认密码：{{ form.r_pwd }}
　　邮箱：{{ form.email }}
　　电话：{{ form.tel }}
　　<input type="submit">
</form>

2、渲染方式二:如果字段很多
class UserForm(forms.Form):
　　name = forms.CharField(min_length=4, label="用户名")
　　pwd = forms.CharField(min_length=4, label="密码")
　　r_pwd = forms.CharField(min_length=4, label="确认密码")
　　email = forms.EmailField(label="邮箱")
　　tel = forms.CharField(label="电话")

def reg(request):
　　form = UserForm(request.POST)
　　return render("reg_html",{"form":form})
-------------------------------
<form>
　　{% csrf_token %}
　　{% for field in form %}
　　　　<div>
　　　　<label for="">{{ field.label }}</label>  {{ field }}
　　　　</div>
　　{% endfor %}
　　<input type="submit">
</form>

-------------------------------
3、渲染方式三,自己搞着玩可以
<form>
　　{% csrf_token %}
　　{{ form.as_p }}
　　<input type="submit">
</form>

4、渲染错误信息

-------视图函数------
def register(request):
　　if request.method=="POST":
　　　　form=UserForm(request.POST)
　　　　if form.is_valid():
　　　　　　clean = form.cleaned_data
　　　　else:
　　　　　　clean = form.cleaned_data
　　　　　　errors = form.errors
　　  　　# NOTES：这里返回的页面可以保存用户上次已经填过的数据，还包括错误信息
　　　　return render("reg_html",{"form":form})

　　#如果是get请求,渲染空form页面
　　form=UserForm()
　　return render(request,"reg_html",{"form":form})
------------------------------

<form>
　　{% csrf_token %}
　　{% for field in form %}
　　　　<div>　　　　
　　　　　　<label for="">{{ field.label }}</label>
　　　　 　　{{ field }}
　　　　　　<span>{{ field.errors.0 }}</span>
　　　　</div>
　　{% endfor %}
　　<input type="submit">
</form>

--------------------------------