校验数据
from app01 import views
# 将校验的数据组成字典的形式传入即可
form_obj = views.MyForm({'username':'jason','password':'123','email':'123'})
# 判断数据是否合法
form_obj.is_valid()
# 查看所有校验通过的数据
form_obj.cleaned_data
# 查看所有不符合校验规则以及不符合的原因
form_obj.errors
{
'email': ['Enter a valid email address.']
}
# 校验数据只校验类中出现的字段 多传不影响 多传的字段直接忽略
# 校验数据 默认情况下 类里面所有的字段都必须传值
数据可以多传不能少传
渲染标签
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='用户名')
展示提示信息
浏览器会自动校验数据 但是前端的校验弱不禁风
让浏览器不做校验
<form action="" method="post" novalidate>
def index(request):
# 1 先产生一个空对象
form_obj = MyForm()
if request.method == 'POST':
form_obj = MyForm(request.POST)
if form_obj.is_valid():
return HttpResponse('OK')
return render(request,'index.html',locals())
{% for form in form_obj %}
<p>
{{ form.label }}:{{ form }} # 输入信息
<span style="color: red">{{ form.errors.0 }}</span> # 后面的提示，占位
</p>
{% endfor %}
1.get请求和post传给html页面对象变量名必须一样，鸭子类型
2.forms组件数据不合法的情况下 会保存上次的数据 基于之前的结果进行修改，更加的人性化
# 针对错误的提示信息还可以自己自定制
class MyForm(forms.Form):
username = forms.CharField(min_length=3,max_length=8,label='用户名',
error_messages={
'min_length':'用户名最少3位',
'max_length':'用户名最大8位',
'required':"用户名不能为空"
}
)
email = forms.EmailField(label='邮箱',
error_messages={
'invalid':'邮箱格式不正确',
'required': "邮箱不能为空"
}
)
钩子函数(HOOK)
钩子函数在forms组件中就类似于第二道关卡，自定义校验规则
在forms组件中有两类钩子
1.局部钩子
给单个字段增加校验
2.全局钩子
给多个字段增加校验
# 局部钩子
def clean_username(self):
username = self.cleaned_data.get('username')
if '666' in username:
self.add_error('username','光喊666是不行滴～')
return username
# 全局钩子
def clean(self):
password = self.cleaned_data.get('password')
confirm_password = self.cleaned_data.get('confirm_password')
if not confirm_password == password:
self.add_error('confirm_password','两次密码不一致')
return self.cleaned_data
label 字段名
error_messages 自定义报错信息
initial 默认值
required 控制字段是否必填
widget=forms.widgets.PasswordInput(attrs={'class':'form-control c1 c2'})
# 多个属性值的话 直接空格隔开即可
# 第一道关卡里面还支持正则校验
validators=[
RegexValidator(r'^[0-9]+$', '请输入数字'),
RegexValidator(r'^159[0-9]+$', '数字必须以159开头')
]
其他类型渲染
# radio
gender = forms.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
# select
hobby = forms.ChoiceField(
widget=forms.widgets.Select()
)
# 多选
hobby1 = forms.MultipleChoiceField(
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
# 单选checkbox
keep = forms.ChoiceField(
choices=(('True','l'),('False',0)),
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
# 多选checkbox
hobby2 = forms.MultipleChoiceField(
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
"""
切入点:
form_obj.is_valid()
"""
def is_valid(self):
return self.is_bound and not self.errors
self.is_bound = data is not None or files is not None
@property
def errors(self):
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()
