forms组件介绍 form组件校验源码
forms组件能实现的功能：
例如购物：选取了货物之后 会计算一个价格发送给后端 如果后端不做价格的校验，实际是获取到用户选择的所有商品的主键值
，然后在后端查询出所有商品的价格 再次计算一遍，如果跟前端一致 那么完成支付如果不一致直接拒绝
1.渲染html代码 2.校验数据 3.展示提示信息
基本使用：
from django import forms
#
#from django.forms import Form class MyForm(forms.Form): # username字符串类型最小3位最大8位 username = forms.CharField(min_length=3,max_length=8) # password字符串类型最小3位最大8位 password = forms.CharField(min_length=3,max_length=8) # email字段必须符合邮箱格式 xxx@xx.com email = forms.EmailField()
注意：
#form=myforms.MyForm(data)实例化得到对象 # 校验数据:form.is_valid() 返回布尔类型 #form.cleaned_data) # 不一定是上面传入的数据，是通过校验的数据
""" 1.测试环境的准备 可以自己拷贝代码准备 2.其实在pycharm里面已经帮你准备一个测试环境 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组件只会自动帮你渲染获取用户输入的标签(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='用户名') """
展示提示信息
""" 浏览器会自动帮你校验数据 但是前端的校验弱不禁风 如何让浏览器不做校验 <form action="" method="post" novalidate> """ def index(request): # 1 先产生一个空对象 form_obj = MyForm() if request.method == 'POST': # 获取用户数据并且校验 """ 1.数据获取繁琐 2.校验数据需要构造成字典的格式传入才行 ps:但是request.POST可以看成就是一个字典 """ # 3.校验数据 form_obj = MyForm(request.POST) # 4.判断数据是否合法 if form_obj.is_valid(): # 5.如果合法 操作数据库存储数据 return HttpResponse('OK') # 5.不合法 有错误 # 2 直接将该空对象传递给html页面 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字符串类型最小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': "邮箱不能为空" } )
label 字段名 error_messages 自定义报错信息 initial 默认值 required 控制字段是否必填 """ 1.字段没有样式 2.针对不同类型的input如何修改 text password date radio checkbox ... """ widget=forms.widgets.PasswordInput(attrs={'class':'form-control c1 c2'}) # 多个属性值的话 直接空格隔开即可 # 第一道关卡里面还支持正则校验 validators=[ RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头') ]
1 form对象.errors 字典 2 name对象.errors ## 视图函数 def register(request): if request.method=='GET': form=myforms.MyForm() return render(request, 'register.html',{'form':form}) else: form=myforms.MyForm(request.POST) if form.is_valid(): return redirect('http://www.baidu.com') else: return render(request, 'register.html',{'form':form}) ## 模板 <form action="" method="post" novalidate> {% for foo in form %} <div class="form-group"> <label for="">{{ foo.label }}</label> {{ foo }} <span class="text-danger pull-right">{{ foo.errors }}</span> </div> {% endfor %} <div class="text-center"> <input type="submit" value="提交" class="btn btn-danger"> </div> </form>
# 定制模板中的显示样式，及配置类 # widget=widgets.PasswordInput(attrs={'class': 'form-control'}) # 错误信息中文显示 error_messages={'min_length': '太短了'} class MyForm(forms.Form): # 校验这个字段，最大长度是32，最小长度是3 name = forms.CharField(required=False, max_length=32, min_length=3, label='用户名', widget=widgets.TextInput(attrs={'class': 'form-control'}), error_messages={'min_length': '太短了'}) password = forms.CharField(required=False, max_length=32, min_length=3, label='密码', widget=widgets.PasswordInput(attrs={'class': 'form-control'}), error_messages={'min_length': '太短了'}) re_password = forms.CharField(required=False, max_length=32, min_length=3, label='确认密码', widget=widgets.PasswordInput(attrs={'class': 'form-control'}), error_messages={'min_length': '太短了'}) email = forms.EmailField(label='邮箱', error_messages={'required': '小惠子，这个必填'}, widget=widgets.TextInput(attrs={'class': 'form-control'})) age = forms.IntegerField(max_value=200, min_value=0, label='年龄', widget=widgets.TextInput(attrs={'class': 'form-control'})) text = forms.CharField(label='个人简介', widget=widgets.Textarea(attrs={'class': 'form-control'})) date = forms.CharField(label='出生日期', widget=widgets.DateInput(attrs={'class': 'form-control'}))
form组件校验源码：
### 1 写一个类，类里写要校验的字段 class MyForm(forms.Form): # 校验这个字段，最大长度是32，最小长度是3 name = forms.CharField(required=False, max_length=32, min_length=3,label='用户名') email = forms.EmailField(label='邮箱') age=forms.IntegerField(max_value=200,min_value=0,label='年龄') ### 2 视图函数中使用 def register(request): # 数据可以是从前端传过来的，也可以是自己后台的数据 # 我现在有以下数据 data={'name':'lqz','email':'33333@qq.com','age':900} # data={'email':'33333@qq.com','age':100} # data={'age':100} # 校验数据是否合法 # 实例化得到form对象，把要校验的数据传入 form=myforms.MyForm(data) # 校验数据:form.is_valid() 返回布尔类型 if form.is_valid(): print('校验通过') # 校验通过的数据 print(form.cleaned_data) # 不一定是上面传入的数据 else: print(form.cleaned_data) print('校验失败') # 哪个字段失败了？失败的原因是什么 print(form.errors) print(type(form.errors)) from django.forms.utils import ErrorDict #### 重写了__str__ print(form.errors.as_json()) print(form.errors.as_data()) # form.errors.as_ul() # 是为了渲染模板 return HttpResponse('ok')
forms渲染模板功能
## 视图函数 def register(request): if request.method=='GET': form=myforms.MyForm() return render(request,'register.html',{'form':form}) elif request.method=='POST': # 数据校验 form=myforms.MyForm(request.POST) if form.is_valid(): print('校验通过，存数据库') else: print(form.errors.as_data()) print('校验失败，返回错误') return HttpResponse('ok') ## 模板 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <hr> <h1>手动创建模板</h1> <form action="" method="post"> <p>用户名：<input type="text" name="name"></p> <p>邮箱：<input type="text" name="email"></p> <p>年龄：<input type="text" name="age"></p> <p><input type="submit" value="提交"></p> </form> <hr> <h1>半自动渲染模板1</h1> <form action="" method="post"> <p>用户名：{{ form.name }}</p> <p>邮箱：{{ form.email }}</p> <p>年龄：{{ form.age }}</p> <p><input type="submit" value="提交"></p> </form> <h1>半自动渲染模板2(用的最多)</h1> <form action="" method="post"> <p>{{ form.name.label }}--{{ form.name }}</p> <p>{{ form.email.label }}---{{ form.email }}</p> <p>{{ form.age.label }}---{{ form.age }}</p> <p><input type="submit" value="提交"></p> </form> <h1>半自动渲染模板3(用的最多)</h1> <form action="" method="post"> {% for foo in form %} <p>{{ foo.label }} :{{ foo }}</p> {% endfor %} <p><input type="submit" value="提交"></p> </form> <h1>全自动(了解)</h1> <form action="" method="post"> {# {{ form.as_ul }}#} {{ form.as_p }} {# <table>#} {# {{ form.as_table }}#} {# </table>#} <p><input type="submit" value="提交"></p> </form> </body> </html>
1 读的入口是: form.is_valid()--->self.errors(BaseForm类)---》self.full_clean()(BaseForm类)--》 -self._clean_fields(局部数据校验)和self._clean_form(全局数据校验) 2 self._clean_fields（BaseForm类） for name, field in self.fields.items(): try: # 字段自己的校验（最大值，最小值，是不是邮箱格式） value = field.clean(value) self.cleaned_data[name] = value if hasattr(self, 'clean_%s' % name): # 反射判断有没有clean_字段名 value = getattr(self, 'clean_%s' % name)() self.cleaned_data[name] = value except ValidationError as e: self.add_error(name, e) 3 self._clean_form（BaseForm类） 全局钩子 try: cleaned_data = self.clean() # self.clean执行的是自己类的clean方法 except ValidationError as e: self.add_error(None, e)
面向切面编程（AOP OOP：面向对象编程）
其他类型渲染
# 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()#使用CheckboxInput来展示一个复选框。当用户勾选该复选框时，提交的表单数据中 ，#accept_terms字段的值将会是True，否则为False。 ) # 多选checkbox hobby2 = forms.MultipleChoiceField( choices=((1, "篮球"), (2, "足球"), (3, "双色球"),), label="爱好", initial=[1, 3], widget=forms.widgets.CheckboxSelectMultiple() #多选 )
浙公网安备 33010602011771号