一 创建一个form组件
导入forms模块组件：from django import forms
创建组件：创建一个类继承者forms.Form这个类
类型：
CharField：字符串类型，min_length：字符长度不能小于多少；max_length：字符的长度不能大于多少，error_messages：可以根据保存信息显示对应的中文报错，required：该字段不能够为空，widget：对input标签操作。
IntegerField：整数类型，invalid：格式错误
MultiplechioceField：设置字段为多选框（单选框）。initial=[数字,]：初始个数。choices=((value,数据),(value,数据))：为多选框（单选框赋值）。widgets.CheckboxSelectMultiple：设置为复选框
其他类型：
Field required=True, 是否允许为空 widget=None, HTML插件 label=None, 用于生成Label标签或显示内容 initial=None, 初始值 help_text=‘‘, 帮助信息(在标签旁边显示) error_messages=None, 错误信息 {‘required‘: ‘不能为空‘, ‘invalid‘: ‘格式错误‘} show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直） 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类型 ...
根据不同要求为表单加上不同的属性值：导入from django.forms impost widgets
widgets.PasswoedInput：加上密文的属性值，addrs：为指定的标签加上属性。
widgets.TextInput：文本信息
widgets.Select：下拉菜单，choices：为option出入值和value属性值
钩子clean：首先导入异常：from django.core.exceptions import ValidationError。
局部钩子：clean_字段名，就是使用clean_加上一个字段名。用于字段校验
raise calidationsError：抛出错误信息
cleaned_data：如果符合条件，数据就会存放在这里面，可以使用get获取是一个有序的字典格式，从上往下依次判断添加。
for name, field in self.fields.items():
try:
value = field.clean(value)
self.cleaned_data[name] = value
if hasattr(self, ‘clean_%s‘ % name):
value = getattr(self, ‘clean_%s‘ % name)()
self.cleaned_data[name] = value
except ValidationError as e:
self.add_error(name, e)
全局钩子：clean，直接在这个函数里面定义功能，可以用于多个字段的操作和比较，直接可以获取cleaned_data里面的数据。
__all__：全局抛出来的错误存放在这个里面的。
self.clean() # def self.clean():return self.cleaned_data
return not self.errors # True或者False
from django import forms from django.forms import widgets from django.core.exceptions import ValidationError class LoginForm(forms.Form): user=forms.CharField(min_length=5,max_length=12, error_messages={ "required":"该字段不能为空", "min_length":"该字段的长度不能小于5", "max_length":"该字段的长度不能大于12"}, widget=widgets.TextInput(attrs={"class":"form-control"}) ) pwd=forms.CharField( error_messages={ "invalid": "必须是数字" }, widget=widgets.PasswordInput(attrs={"class":"form-control",}) ) gender=forms.CharField( widget=widgets.Select(choices=((1,‘男‘),(0,‘女‘),)) ) usersss = forms.MultipleChoiceField( initial=[2, ], choices=((1, ‘上海‘), (2, ‘北京‘),), widget=widgets.CheckboxSelectMultiple ) def clean_user(self): print("============",self.cleaned_data.get("pwd")) # ============ None if not self.cleaned_data.get("user").isdigit(): return self.cleaned_data.get("user") else: raise ValidationError("该字段不能是纯数字") def clean_pwd(self): print("-----------------",self.cleaned_data.get("user")) import re val=self.cleaned_data.get("pwd") ret=re.findall("^\d{6}yuan$",val) if ret: return val else: raise ValidationError("密码不符合设定要求") def clean(self): if self.cleaned_data.get("user") and self.cleaned_data.get("pwd"): if self.cleaned_data.get("user") != self.cleaned_data.get("pwd"): return self.cleaned_data else: raise ValidationError("用户名与密码不能一致!") return self.cleaned_data
django内置插件：
TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget
常用选择插件：
# 单radio，值为字符串 # user = fields.CharField( # initial=2, # widget=widgets.RadioSelect(choices=((1,‘上海‘),(2,‘北京‘),)) # ) # 单radio，值为字符串 # user = fields.ChoiceField( # choices=((1, ‘上海‘), (2, ‘北京‘),), # initial=2, # widget=widgets.RadioSelect # ) # 单select，值为字符串 # user = fields.CharField( # initial=2, # widget=widgets.Select(choices=((1,‘上海‘),(2,‘北京‘),)) # ) # 单select，值为字符串 # user = fields.ChoiceField( # choices=((1, ‘上海‘), (2, ‘北京‘),), # initial=2, # widget=widgets.Select # ) # 多选select，值为列表 # user = fields.MultipleChoiceField( # choices=((1,‘上海‘),(2,‘北京‘),), # initial=[1,], # widget=widgets.SelectMultiple # ) # 单checkbox # user = fields.CharField( # widget=widgets.CheckboxInput() # ) # 多选checkbox,值为列表 # user = fields.MultipleChoiceField( # initial=[2, ], # choices=((1, ‘上海‘), (2, ‘北京‘),), # widget=widgets.CheckboxSelectMultiple # )
二 实例form对象
实例化时:
self.fields={
"username":"字段规则对象",
"password":"字段规则对象",
}
LoginForm：form自建实例的对象存放的地点，request.POST：将数据传递给对应的字段，绑定数据的表单实例
is_valid：校验，将检验是否符合要求，返回的是一个布尔值
cleaned_data：检验正确数据就存放在这里面，是以字典的格式存放的，出数据。
errors：检验没有通过或错误的信息存放在这个里面，是以字典的格式存放的。errors.get获取里面的某些数据。
from django.shortcuts import render,HttpResponse # Create your views here. from django import forms from .models import * from django.forms import widgets from .forms import * def login(request): if request.method=="POST": #print(request.POST) #<QueryDict: {‘csrfmiddlewaretoken‘: [‘0xrifjX7jplIZwngbrRjpHPXw6kyDVa2Erca0sGYfjH9UuDfHzNUdMzlh7EH2v44‘], ‘user‘: [‘asdas‘], ‘pwd‘: [‘12321321‘]}> login_form=LoginForm(request.POST) # 将数据传给对应字段 绑定数据的表单实例 ‘‘‘ # self.cleaned_data={"pwd":"12312412"} # self.errors={"user":"yuan",} ‘‘‘ if login_form.is_valid(): print("通过验证") print(login_form.cleaned_data) print("use:",login_form.cleaned_data.get("user")) print(login_form.errors) ############### # user=login_form.cleaned_data.get("user") # pwd=login_form.cleaned_data.get("pwd") # UserInfo.objects.filter(username=user,password=pwd) # UserInfo.objects.filter(**login_form.cleaned_data) return HttpResponse("OK") else: # print("验证失败") # print(login_form.cleaned_data) # {‘pwd‘: 77777} # print(login_form.errors) # ################## login_form.errors是什么类型 # print(type(login_form.errors))# <class ‘django.forms.utils.ErrorDict‘> # ###################获取login_form.errors的某个键的值 # print(login_form.errors.get("user")) # print(type(login_form.errors.get("pwd")))# <class ‘django.forms.utils.ErrorList‘> # # #login_form.errors={"user":["小于5位","不是数字"],"pwd":["",""]} errors=login_form.errors# {"user":["该字段不能是纯数字",],"pwd":["",""]} print("errors-->",errors) error_all=errors.get("__all__") return render(request, "login.html", {"login_form": login_form,"errors":errors,"error_all":error_all}) #### get请求 login_form=LoginForm() # form组件的实例对象 未绑定表单实例 return render(request,"login.html",{"login_form":login_form})
三 html文件渲染
模板导入input标签：直接用对象.字段取出内容 {{ 对象.字段}}
模板导入错误信息：直接使用srrors.字段名.0取出数据{{ srrors.字段名.0 }}
form组件只能够直接渲染input标签，form标签还是需要自己写的。
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> <!-- 新 Bootstrap 核心 CSS 文件 --> <link rel="stylesheet" href="//cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css"> <style> .container{ margin-top: 100px; } </style> </head> <body> <div class="container"> <div class="row"> <div class="col-md-6"> <form action="/login/" method="post"> {% csrf_token %} <div class="form-group"> <label for="user">user</label> {{ login_form.user }} <span>{{ errors.user.0 }}</span> </div> <div class="form-group"> <label for="pwd">pwd</label> {{ login_form.pwd }} <span>{{ errors.pwd.0 }}</span> </div> <div class="form-group"> <label for="gender">gender</label> {{ login_form.gender }}<span>{{ error_all.0 }}</span> </div> <p>{{ login_form.usersss }}</p> <button type="submit" class="btn btn-default">Submit</button> </form> <hr> {# <form action="">#} {# {{ login_form.as_p }}#} {# </form>#} </div> </div> </div> </body> </html>
四 其他渲染对象
对于<label>/<input> 对，还有几个输出选项：
{{ form.as_table }}以表格的形式将它们渲染在<tr>标签中{{ form.as_p }}将它们渲染在<p>标签中{{ form.as_ul }}将它们渲染在<li>标签中
注意，你必须自己提供<table> 或<ul> 元素。
{{ form.as_p }}结果如下：
<form action=""> <p> <label for="id_username">Username:</label> <input id="id_username" maxlength="100" name="username" type="text" required=""> </p> <p> <label for="id_password">Password:</label> <input id="id_password" maxlength="100" name="password" placeholder="password" type="password" required=""> </p> <p> <label for="id_telephone">Telephone:</label> <input id="id_telephone" name="telephone" type="number" required=""> </p> <p> <label for="id_email">Email:</label> <input id="id_email" name="email" type="email" required=""> </p> <p> <label for="id_is_married">Is married:</label> <input id="id_is_married" name="is_married" type="checkbox"> </p> <input type="submit" value="注册"> </form>
这种渲染有了限制，不能个自定义的渲染，而是将所有的字段全部渲染过去。
手动渲染：我们没有必要非要让Django 来分拆表单的字段；如果我们喜欢，我们可以手工来做每个字段都是表单的一个属性，可以使用{{ form.name_of_field }} 访问，并将在Django 模板中正确地渲染
<div class="fieldWrapper">
{{ form.Username.errors }}
{{ form.Username.label_tag }}
{{ form.Username }}
</div>
五 表单渲染的错误信息
registerForm=RegisterForm(request.POST) print(type(registerForm.errors)) #<class ‘django.forms.utils.ErrorDict‘> print(type(registerForm.errors["username"])) #<class ‘django.forms.utils.ErrorList‘>
使用{{ form.name_of_field.errors }} 显示表单错误的一个清单，并渲染成一个ul。看上去可能像：
<ul class="errorlist">
<li>Sender is required.</li>
</ul>
