一、forms组件
基本使用
视图层
1#第一步：导入forms 2from django import forms 3from django.forms import widgets 4#第二步：定义的类 5class User_form(forms.Form): 6#第三步：设置字段与相对应的对象 7 name = forms.CharField(max_length=10,min_length=3) 8 pwd = forms.CharField(max_length=10,min_length=3,widget=widgets.PasswordInput()) 9 re_pwd = forms.CharField(max_length=10,min_length=3,widget=widgets.PasswordInput()) 10 email = forms.EmailField() 11 12def index(request): 13 if request.method == 'GET': 14 return render(request,'index.html') 15 if request.method == 'POST': 16 #第四步：实例化产生对象 17 form = User_form(request.POST) 18 # is_valid如果是true表示校验成功,反之,校验失败 19 if form.is_valid(): 20 print(form.cleaned_data) 21 else: 22 # ErrorDict : {"校验错误的字段":["错误信息",]} 23 print(form.errors) 24 # ErrorList ["错误信息",] 25 print(form.errors.get("name")) 26 return render(request, 'index.html',locals())
模型层
1<form action="" method="post"> 2 <div> 3 <label for="user">用户名</label> 4 <p><input type="text" name="name" id="name"></p> 5 </div> 6 <div> 7 <label for="pwd">密码</label> 8 <p><input type="password" name="pwd" id="pwd"></p> 9 </div> 10 <div> 11 <label for="r_pwd">确认密码</label> 12 <p><input type="password" name="re_pwd" id="re_pwd"></p> 13 </div> 14 <div> 15 <label for="email">邮箱</label> 16 <p><input type="text" name="email" id="email"></p> 17 </div> 18 <input type="submit"> 19</form>
注：
1#第二步： 2 定义的类必须继承forms.Form，forms类定义过的属性默认非空。 3 4#第四步： 5 需要注意的是给对象传入字典就可以做一个个值的校验。 6 但是我们需要的是form表单属性与forms组件字段的校验，因此需要把request.POST传入forms对象。 7 form表单的name属性值应该与forms组件的字段名称一致，不一致的键值不会去做校验。 8 9#form.cleaned_data 10 字段值符合要求的放在cleaned_data中。字典数据类型。 11 12#form.errors 13 字段不符合要求的对应的键作为键，错误信息作为值。虽然返回结果比较复杂，但依然是字典数据类型， 14 可以通过form.errors.get(“不符合的键”)来拿到键值，键值为列表数据类型。 15 因此可以通过form.errors.get("不符合键")[0]拿到错误信息。
语法
1常用字段: 2 Charfield 3 RegexField 4 IntegerField 5 EmailField 6常用参数： 7 max_length， 8 min_length， 9 error_messages={ 10 'required':'用户名不能为空', 11 'max_length':'太长了', 12 'min_length':'太短了', 13 'invalid': '不符合邮箱格式' # 凡是遇到格式错误的，都用 invalid 14 }, 15 widget=widgets.插件(attrs={})）,# 插件,可以设置类名，attrs={'class':'form-control'} 16 label='用户名', # obj.t1.label 17 required=True, # 默认为True,在前端就要求必须填写,空会提示 18 disabled=False, # 是否可以编辑
内置字段
1Field 2 required=True, 是否允许为空 3 widget=None, HTML插件 4 label=None, 用于生成Label标签或显示内容 5 initial=None, 初始值 6 help_text='', 帮助信息(在标签旁边显示) 7 error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'} 8 show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直） 9 validators=[], 自定义验证规则 10 localize=False, 是否支持本地化 11 disabled=False, 是否可以编辑 12 label_suffix=None Label内容后缀 13 14 15CharField(Field) 16 max_length=None, 最大长度 17 min_length=None, 最小长度 18 strip=True 是否移除用户输入空白 19 20IntegerField(Field) 21 max_value=None, 最大值 22 min_value=None, 最小值 23 24FloatField(IntegerField) 25 ... 26 27DecimalField(IntegerField) 28 max_value=None, 最大值 29 min_value=None, 最小值 30 max_digits=None, 总长度 31 decimal_places=None, 小数位长度 32 33BaseTemporalField(Field) 34 input_formats=None 时间格式化 35 36DateField(BaseTemporalField) 格式：2015-09-01 37TimeField(BaseTemporalField) 格式：11:12 38DateTimeField(BaseTemporalField)格式：2015-09-01 11:12 39 40DurationField(Field) 时间间隔：%d %H:%M:%S.%f 41 ... 42 43RegexField(CharField) 44 regex, 自定制正则表达式 45 max_length=None, 最大长度 46 min_length=None, 最小长度 47 error_message=None, 忽略，错误信息使用 error_messages={'invalid': '...'} 48 49EmailField(CharField) 50 ... 51 52FileField(Field) 53 allow_empty_file=False 是否允许空文件 54 55ImageField(FileField) 56 ... 57 注：需要PIL模块，pip3 install Pillow 58 以上两个字典使用时，需要注意两点： 59 - form表单中 enctype="multipart/form-data" 60 - view函数中 obj = MyForm(request.POST, request.FILES) 61 62URLField(Field) 63 ... 64 65 66BooleanField(Field) 67 ... 68 69NullBooleanField(BooleanField) 70 ... 71 72ChoiceField(Field) 73 ... 74 choices=(), 选项，如：choices = ((0,'上海'),(1,'北京'),) 75 required=True, 是否必填 76 widget=None, 插件，默认select插件 77 label=None, Label内容 78 initial=None, 初始值 79 help_text='', 帮助提示 80 81 82ModelChoiceField(ChoiceField) 83 ... django.forms.models.ModelChoiceField 84 queryset, # 查询数据库中的数据 85 empty_label="---------", # 默认空显示内容 86 to_field_name=None, # HTML中value的值对应的字段 87 limit_choices_to=None # ModelForm中对queryset二次筛选 88 89ModelMultipleChoiceField(ModelChoiceField) 90 ... django.forms.models.ModelMultipleChoiceField 91 92 93 94TypedChoiceField(ChoiceField) 95 coerce = lambda val: val 对选中的值进行一次转换 96 empty_value= '' 空值的默认值 97 98MultipleChoiceField(ChoiceField) 99 ... 100 101TypedMultipleChoiceField(MultipleChoiceField) 102 coerce = lambda val: val 对选中的每一个值进行一次转换 103 empty_value= '' 空值的默认值 104 105ComboField(Field) 106 fields=() 使用多个验证，如下：即验证最大长度20，又验证邮箱格式 107 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),]) 108 109MultiValueField(Field) 110 PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用 111 112SplitDateTimeField(MultiValueField) 113 input_date_formats=None, 格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y'] 114 input_time_formats=None 格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M'] 115 116FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中 117 path, 文件夹路径 118 match=None, 正则匹配 119 recursive=False, 递归下面的文件夹 120 allow_files=True, 允许文件 121 allow_folders=False, 允许文件夹 122 required=True, 123 widget=None, 124 label=None, 125 initial=None, 126 help_text='' 127 128GenericIPAddressField 129 protocol='both', both,ipv4,ipv6支持的IP格式 130 unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用 131 132SlugField(CharField) 数字，字母，下划线，减号（连字符） 133 ... 134 135UUIDField(CharField) uuid类型 136 ...
二、模型层渲染
方式一
灵活性最高，但比较low
1<form action="" method="post"> 2 <div> 3 <label for="user">用户名:</label> 4 {{ form.name }} 5 </div> 6 <div> 7 <label for="pwd">密码:</label> 8 {{ form.pwd }} 9 </div> 10 <div> 11 <label for="r_pwd">确认密码:</label> 12 {{ form.re_pwd }} 13 </div> 14 <div> 15 <label for="email">邮箱:</label> 16 {{ form.email }} 17 </div> 18 <input type="submit"> 19</form>
方式二
推荐使用
视图层
1#首先要添加每个字段的label属性 2class User_form(forms.Form): 3 name = forms.CharField(label='用户名：',max_length=10,min_length=3) 4 pwd = forms.CharField(label='密码：',max_length=10,min_length=3,widget=widgets.PasswordInput()) 5 re_pwd = forms.CharField(label='确认密码：',max_length=10,min_length=3,widget=widgets.PasswordInput()) 6 email = forms.EmailField(label='邮箱：',)
模版层
1<form action="" method="post"> 2 {% for foo in form %} 3 <div> 4 <label>{{ foo.label }}</label> 5 {{ foo }} 6 </div> 7 {% endfor %} 8 <input type="submit"> 9</form>
方式三
写死了，不推荐使用
视图层
1#首先要添加每个字段的label属性 2class User_form(forms.Form): 3 name = forms.CharField(label='用户名',max_length=10,min_length=3) 4 pwd = forms.CharField(label='密码',max_length=10,min_length=3,widget=widgets.PasswordInput()) 5 re_pwd = forms.CharField(label='确认密码',max_length=10,min_length=3,widget=widgets.PasswordInput()) 6 email = forms.EmailField(label='邮箱',)
模版层
1<form action="" method="post"> 2 {{ form.as_p }} 3 <!--相当于在循环form的字段，每循环一次，获得相对应的html标签 4 <p> 5 <label for="id_name"> 6 用户名: 7 </label> 8 <input type="text" name="name" maxlength="10" minlength="3" required id="id_name" /> 9 </p> 10--> 11 {{ form.as_li }} 12 <!--相当于在循环form的字段，每循环一次，获得相对应的html标签 13 <li> 14 <label for="id_name"> 15 用户名: 16 </label> 17 <input type="text" name="name" maxlength="10" minlength="3" required id="id_name" /> 18 </li> 19--> 20 {{ form.as_table }} 21 <!--相当于在循环form的字段，每循环一次，获得相对应的html标签 22 <tr> 23 <th> 24 <label for="id_name"> 25 用户名: 26 </label> 27 </th> 28 <td> 29 <input type="text" name="name" maxlength="10" minlength="3" required id="id_name" /> 30 </td> 31 </tr> 32--> 33 <input type="submit"> 34</form>
四、渲染错误信息
1<form action="" method="post" novalidate> 2 {% for foo in form %} 3 <div> 4 <label >{{ foo.label }}</label> 5 {{ foo }} 6 <!--渲染错误信息:foo.errors.0--> 7 <span>{{ foo.errors.0 }}</span> 8 </div> 9 {% endfor %} 10 <input type="submit"> 11</form>
自定义错误信息
1class User_form(forms.Form): 2 name = forms.CharField(label='用户名', max_length=10, min_length=3,error_messages={'max_length': '最长是8', 'min_length': '最短是3', 'required': '这个必须填'}) 3 pwd = forms.CharField(label='密码', max_length=10, min_length=3, widget=widgets.PasswordInput(),error_messages={'max_length': '最长是8', 'min_length': '最短是3', 'required': '这个必须填'}) 4 re_pwd = forms.CharField(label='确认密码', max_length=10, min_length=3, widget=widgets.PasswordInput(), error_messages={'max_length': '最长是8', 'min_length': '最短是3', 'required': '这个必须填'}) 5 email = forms.EmailField(label='邮箱', error_messages={'required': '这个必须填','invalid': '不符合邮箱格式'})
五、局部钩子
局部钩子可以对单个字段进行自定义的验证，只有当所有的内部验证都通过后，才会进行自定义验证
在Form类中自定义一个方法，方法名称有固定格式：clean_字段名称。Django内部会自动执行该方法对字段进行验证，这个方法必须将验证正确的值返回。验证错误需要抛出ValidationError错误。
1from django.core.exceptions import ValidationError 2def clean_name(self): 3 name = self.cleaned_data.get('name') 4 if not name[0].isalpha(): 5 raise ValidationError('必须以字母开头') 6 return name
六、全局钩子
需求：在注册账号时，填写密码后，还要再次填写确认密码，然后比较两次密码是否一致，一致后才能正常注册。
对所有字段做整体验证，django预留了clean钩子方法，可以自定制处理逻辑代码，但是clean方法必须返回self.cleaned_data，如下列示例代码
1from django.core.exceptions import ValidationError 2def clean(self): 3 print(self.cleaned_data) 4 pwd = self.cleaned_data.get('pwd') 5 re_pwd = self.cleaned_data.get('re_pwd') 6 if pwd !=re_pwd: 7 raise ValidationError('两次密码不一致') 8 return self.cleaned_data