Django Form组件
Form介绍
我们在HTML页面中利用form表单向后端提交数据时，都会写一些获取用户输入的标签并且用form标签把它们包起来。
与此同时我们在好多场景下都需要对用户的输入做校验，比如校验用户是否输入，输入的长度和格式等正确与否。如果用户输入的内容有错误就需要在页面上相应的位置显示对应的错误信息.。
Django form组件就实现了上面所述的功能。
总结一下，其实form组件的主要功能如下:
- 渲染标签
- 对用户提交的数据进行校验
- 保留上次输入内容
普通方式手写注册功能
思路：
1.手写获取用户输入的前端页面代码 渲染页面
2.后端获取用户数据并做合法性校验 校验数据
3.将校验之后的结果渲染到前端页面 展示信息
def register(request): error_dict = {'username':'','password':''} if request.method =='POST': username = request.POST.get("username") password = request.POST.get('password') if "Jin瓶梅" in username: #提示报错信息 error_dict['username'] = '不符合核心价值观' if not password: #提示报错信息 error_dict['password'] = '密码不能为空' return render(request,'register.html',locals())
<body> <form action="" method="post"> <p>用户名： <input type="text" name="username"> <span style="color:red">{{ error_dict.username }}</span> </p> <p>密码： <input type="text" name="password"> <span style="color:red">{{ error_dict.password }}</span> </p> <input type="submit"> </form> </body>
使用form组件实现注册功能
views.py
#需要先写一个类 class MyRegForm(forms.Form): #用户名最少3位最多8位 username = forms.CharField(max_length=8,min_length=3) password = forms.CharField(max_length=8,min_length=3) #email字段必须填写符合邮箱格式的数据 email = forms.EmailField()
如何校验数据：
# 1.传入待校验的数据 用自己写的类 传入字典格式的待校验的数据 form_obj = views.MyRegForm({'username': 'hank', 'password': 123, 'email': '123456'}) # 2.判断数据是否符合校验规则 form_obj.is_valid() #False 该方法只有在所有的数据全部符合校验规则才会返回True # 3.如何获取校验之后通过的数据 form_obj.cleaned_data #{'username': 'hank', 'password': '123'} # 4.如何获取校验失败及失败的原因 form_obj.errors #{'email': ['Enter a valid email address.']}
注意：forms组件默认所有的字段都必须传值。
传少了肯定不行，而传多了则没有任何关系，只校验类里面写的字段 多传的直接忽略了。如下图所示
如何渲染标签
forms组件只帮你渲染获取用户输入(输入 选择 下拉 文件)的标签 不渲染按钮和form表单标签
渲染出来的每一个input提示信息都是类中字段首字母大写
def reg(request): # 1.先生成一个空的类对象 form_obj = MyRegForm() # 2 获取用户数据并交给forms组件校验 if request.method == 'POST': form_obj = MyRegForm(request.POST) # 3 获取校验结果 if form_obj.is_valid(): return HttpResponse('数据没问题') # return render(request, 'reg.html', locals()) else: # 4 获取校验失败的字段和提示信息 print(form_obj.errors) # 5.直接将该对象传给前端页面 return render(request,'reg.html',locals())
<body> <p>第一种渲染方式: 多个p标签 本地测试方便 封装程度太高 不便于扩展</p> {{ form_obj.as_p }} {#{{ form_obj.as_ul }}#} {#{{ form_obj.as_table }}#} <p>第二种渲染方式: 扩展性较高 书写较为繁琐</p> <lable for="{{ form_obj.username.id_for_label }}">{{ form_obj.username.label }}</lable> {{ form_obj.username }} {{ form_obj.password.label }}{{ form_obj.password }} {{ form_obj.email.label }}{{ form_obj.email }} <p>第三种渲染方式 （推荐使用）</p> {% for form in form_obj %} {{ form.label }}{{ form }} {% endfor %} </body>
效果展示：
如何渲染错误信息
def reg(request): # 1.先生成一个空的类对象 form_obj = MyRegForm() # 2 获取用户数据并交给forms组件校验 if request.method == 'POST': form_obj = MyRegForm(request.POST) # 3 获取校验结果 if form_obj.is_valid(): return HttpResponse('数据没问题') # return render(request, 'reg.html', locals()) else: # 4 获取校验失败的字段和提示信息 print(form_obj.errors) # 5.直接将该对象传给前端页面 return render(request,'reg.html',locals())
<p>第三种渲染方式 （推荐使用）</p> <form action="" method="post" novalidate> {% for form in form_obj %} <p> {{ form.label }}{{ form }} <span>{{ form_obj.errors.0 }}</span> </p> {% endfor %} <input type="submit"> </form>
注意：
1.数据校验一个前后端都得有，但是前端的校验弱不禁风 可有可无；而后端的校验则必须非常全面
2.form表单取消前端浏览器自动校验功能 ：
<form action="" method="post" novalidate>
常见参数
label #input框的提示信息 error_messages #自定义报错的提示信息 required #设置字段是否允许为空 initial #设置默认值 widget #控制类型及属性 type/class widget=forms.widgets.TextInput(attrs={'class':'form-control c1'}） widget=forms.widgets.PasswordInput(attrs={'class':'form-control'})
正则校验：
from django.core.validators import RegexValidator class MyForm(forms.Form): user = forms.CharField( validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')], )
单选Select：
class LoginForm(forms.Form): ... hobby = forms.ChoiceField( choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ), label="爱好", initial=3, widget=forms.widgets.Select() )
多选Select：
class LoginForm(forms.Form): ... hobby = forms.MultipleChoiceField( choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ), label="爱好", initial=[1, 3], widget=forms.widgets.SelectMultiple() )
单选Checkbox
class LoginForm(forms.Form): ... keep = forms.ChoiceField( label="是否记住密码", initial="checked", widget=forms.widgets.CheckboxInput() )
多选Checkbox
class LoginForm(forms.Form): ... hobby = forms.MultipleChoiceField( choices=((1, "篮球"), (2, "足球"), (3, "双色球"),), label="爱好", initial=[1, 3], widget=forms.widgets.CheckboxSelectMultiple() )
补充：
Field required=True, 是否允许为空 widget=None, HTML插件 label=None, 用于生成Label标签或显示内容 initial=None, 初始值 help_text='', 帮助信息(在标签旁边显示) error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'} validators=[], 自定义验证规则 localize=False, 是否支持本地化 disabled=False, 是否可以编辑 label_suffix=None Label内容后缀 CharField(Field) max_length=None, 最大长度 min_length=None, 最小长度 strip=True 是否移除用户输入空白 IntegerField(Field) max_value=None, 最大值 min_value=None, 最小值 FloatField(IntegerField) ... DecimalField(IntegerField) max_value=None, 最大值 min_value=None, 最小值 max_digits=None, 总长度 decimal_places=None, 小数位长度 BaseTemporalField(Field) input_formats=None 时间格式化 DateField(BaseTemporalField) 格式：2015-09-01 TimeField(BaseTemporalField) 格式：11:12 DateTimeField(BaseTemporalField)格式：2015-09-01 11:12 DurationField(Field) 时间间隔：%d %H:%M:%S.%f ... RegexField(CharField) regex, 自定制正则表达式 max_length=None, 最大长度 min_length=None, 最小长度 error_message=None, 忽略，错误信息使用 error_messages={'invalid': '...'} EmailField(CharField) ... FileField(Field) allow_empty_file=False 是否允许空文件 ImageField(FileField) ... 注：需要PIL模块，pip3 install Pillow 以上两个字典使用时，需要注意两点： - form表单中 enctype="multipart/form-data" - view函数中 obj = MyForm(request.POST, request.FILES) URLField(Field) ... BooleanField(Field) ... NullBooleanField(BooleanField) ... ChoiceField(Field) ... choices=(), 选项，如：choices = ((0,'上海'),(1,'北京'),) required=True, 是否必填 widget=None, 插件，默认select插件 label=None, Label内容 initial=None, 初始值 help_text='', 帮助提示 ModelChoiceField(ChoiceField) ... django.forms.models.ModelChoiceField queryset, # 查询数据库中的数据 empty_label="---------", # 默认空显示内容 to_field_name=None, # HTML中value的值对应的字段 limit_choices_to=None # ModelForm中对queryset二次筛选 ModelMultipleChoiceField(ModelChoiceField) ... django.forms.models.ModelMultipleChoiceField TypedChoiceField(ChoiceField) coerce = lambda val: val 对选中的值进行一次转换 empty_value= '' 空值的默认值 MultipleChoiceField(ChoiceField) ... TypedMultipleChoiceField(MultipleChoiceField) coerce = lambda val: val 对选中的每一个值进行一次转换 empty_value= '' 空值的默认值 ComboField(Field) fields=() 使用多个验证，如下：即验证最大长度20，又验证邮箱格式 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),]) MultiValueField(Field) PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用 SplitDateTimeField(MultiValueField) input_date_formats=None, 格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y'] input_time_formats=None 格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M'] FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中 path, 文件夹路径 match=None, 正则匹配 recursive=False, 递归下面的文件夹 allow_files=True, 允许文件 allow_folders=False, 允许文件夹 required=True, widget=None, label=None, initial=None, help_text='' GenericIPAddressField protocol='both', both,ipv4,ipv6支持的IP格式 unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用 SlugField(CharField) 数字，字母，下划线，减号（连字符） ... UUIDField(CharField) uuid类型 Django Form内置字段
钩子函数
我们在Fom类中定义 clean_字段名() 方法，就能够实现对特定字段进行校验。
我们在Fom类中定义 clean() 方法，就能够实现对字段进行全局校验。
class MyRegForm(forms.Form): #用户名最少3位最多8位 username = forms.CharField(max_length=8,min_length=3,label='用户名', error_messages={ 'max_length':'用户名最长8位', 'min_length':'用户名最短3位', 'required':'用户名不能位为空' }, initial='hank') password = forms.CharField(max_length=8,min_length=3,label='密码') confirm_password = forms.CharField(max_length=8,min_length=3,label='确认密码') #email字段必须填写符合邮箱格式的数据 email = forms.EmailField(label='邮箱',error_messages={ 'required':'邮箱必填', 'invalid':'邮箱格式不正确' }) # 全局钩子 def clean(self): #校验密码和确认密码是否一致 password = self.cleaned_data.get('password') confirm_password = self.cleaned_data.get('confirm_password') if not password == confirm_password: #展示错误提示信息 self.add_error('confirm_password','两次密码不一致') return self.cleaned_data # 局部钩子 def clean_username(self): #校验用户名中不能包含666 username =self.cleaned_data.get('username') if '666' in username: self.add_error('username','有666是就行的') return self.cleaned_data
如果想同时操作多个字段的数据，就用全局钩子
如果想操作单个字段的数据，就用局部钩子
