Django中的form组件有两大作用
1、验证获取正确的结果或者错误信息
2、生成html代码
一、为什么需要form组件呢？
在写form表单，提交数据时，自己写验证的代码是一件非常困难的事情。
<form action="/test/"method="post">
{% csrf_token %}
<input type="text"name="user">
<input type="password"name="password">
<input type="email"name="email">
<input type="submit" value="提交">
</form>
上述表单提交后，在下面的视图中需要自己处理对提交数据的限制，非常的困难，而form组件能够实现对表单提交的数据进行验证的功能，也支持ajax提交的数据验证，错误是能获取错误信息。
def test(request):
if request.method =="GET":
return render(request,"test.html")
elif request.method == "POST":
user = request.POST.get("user")
password = request.POST.get("password")
email = request.POST.get("email")
print(user,password,email)
return HttpResponse("ok")
二、form组件的创建
先导入forms和fields,创建类和字段。字段中的参数和封装的正则表达式对传入进来的数据进行验证。将post传入进来的数据传入类中实例化生成一个对象，通过方法
is_valid()，可以拿到正确的数据或者错误的信息。
from django import forms
from django.forms import fields class MyForm(forms.Form):
user = fields.CharField(max_length=12,min_length=3,required=True)
password = fields.CharField(max_length=32,required=True)
email = fields.EmailField(required=True)
form_obj = MyForm(request.POST)
if form_obj.is_valid():
# 验证成功后拿到的数据
print(form_obj.cleaned_data)
else:
# 验证失败后，拿到的错误信息
print(form_obj.errors)
三、验证错误信息显示
<form action="/test/"method="post">
{% csrf_token %}
<p><input type="text"name="user">{{ form_obj.errors.user.0 }}</p>
<p><input type="password"name="password">{{ form_obj.errors.password.0 }}</p>
<p><input type="email"name="email">{{ form_obj.errors.email.0 }}</p>
<p><input type="submit" value="提交"></p>
</form>
class MyForm(forms.Form):
user = fields.CharField(max_length=12,min_length=3,required=True,error_messages={
"required":"用户不能为空",
"max_length":"用户名长度不能超过12个字符",
"min_length":"用户名长度不能短于3个字符",
})
password = fields.CharField(max_length=32,required=True,error_messages={
"max_length":"密码长度不能大于32个字符",
"required":"密码不能为空",
})
email = fields.EmailField(required=True,error_messages={
"required":"邮箱不能为空",
"invalid":"请输入邮箱格式",
})
error_message可以将错误信息定制为中文信息。
四、生成html代码
用form组件生成html代码有两个好处，1、当和其他人合作开发时，前端的form表单命名和后端form组件的字段名字不一样时，会出错，当采用form组件自动生成html代码不会存在名字不同的情况。2、可以保留上次输入的信息。
<form action="/test/"method="post">
{% csrf_token %}
<p>{{ form_obj.user }}{{ form_obj.errors.user.0 }}</p>
<p>{{ form_obj.password }}{{ form_obj.errors.password.0 }}</p>
<p>{{ form_obj.email }}{{ form_obj.errors.email.0 }}</p>
<p><input type="submit" value="提交"></p>
</form>
def test(request):
if request.method =="GET":
form_obj = MyForm()
return render(request,"test.html",locals())
elif request.method == "POST":
form_obj = MyForm(request.POST)
if form_obj.is_valid():
# 验证成功后拿到的数据
print(form_obj.cleaned_data)
else:
# 验证失败后，拿到的错误信息
print(form_obj.errors)
return render(request,"test.html",locals())
return HttpResponse("ok")
验证后通过form_obj.cleaned_data拿到的数据为字典，键为form中的字段名，因此当需要通过models.User.objects.create(**form_obj.cleaned_data)方法实现增加数据库中的数据时，需要足以保持model中和form中的字段名称相同。不同时，需要一个一个的传入字段。
五、整体结构
1、字段
字段的作用是提供验证时的格式要求，如果不符合格式要求则在error_message中的invalid定制错误信息。字段包含两样东西，验证的规则，生成html代码的wiget。
2、参数
参数实现对验证规则的正则表达式的定制。其中最重要的参数wiget实现对生成html代码的定制，可以生成不同的输入框（如select，Ridio，CheckBox），还能实现对生成的代码添加属性
3、一些常用实例
select，Ridio，CheckBox
ridio没有直接的字段，可以用其他的字段加上widget生成，一般经常选择的字段有CharField,ChoiceField，IntegerField
下面字段生成的html代码如下。
test = fields.ChoiceField(
required=True,
choices=((1,"重庆"),(2,"成都"),),
widget=widgets.RadioSelect()
)
test = fields.CharField(#用IntegerField一样
required=True,
widget=widgets.RadioSelect(choices=((1,"重庆"),(2,"成都"),),)
)
<ul id="id_test">
<li><label for="id_test_0"><input type="radio" name="test" value="1" required="" id="id_test_0">
重庆</label> </li>
<li><label for="id_test_1"><input type="radio" name="test" value="2" required="" id="id_test_1">
成都</label> </li>
</ul>
select
test = fields.IntegerField(
required=True,
widget=widgets.Select(choices=((1,"重庆"),(2,"成都"),),),
label="city"
)
test = fields.ChoiceField(
required=True,
choices=((1, "重庆"), (2, "成都"),),
widget=widgets.Select(),
label="city"
)
生成的html代码如下
<select name="test" id="id_test">
<option value="1">重庆</option> <option value="2">成都</option> </select>
select多
test = fields.ChoiceField(
required=True,
choices=((1, "重庆"), (2, "成都"),(3,"上海")),
widget=widgets.SelectMultiple(),
label="city"
)
产生的html代码如下：
<select name="test" required="" id="id_test" multiple="multiple">
<option value="1">重庆</option> <option value="2">成都</option> <option value="3">上海</option> </select>
checkbox单
test = fields.ChoiceField(
required=True,
widget=widgets.CheckboxInput(),
label="city"
)
<p>city<input type="checkbox" name="test" required="" id="id_test"></p>
checkbox多
test = fields.ChoiceField(
required=True,
choices=((1,"重庆"),(2,"成都"),(3,"上海")),
widget=widgets.CheckboxSelectMultiple(),
label="city"
)
<ul id="id_test">
<li><label for="id_test_0"><input type="checkbox" name="test" value="1" id="id_test_0">
重庆</label> </li>
<li><label for="id_test_1"><input type="checkbox" name="test" value="2" id="id_test_1">
成都</label> </li>
<li><label for="id_test_2"><input type="checkbox" name="test" value="3" id="id_test_2">
上海</label> </li>
</ul>
六、select选择数据库中的数据时，采用上面的创建类和字段的方法不能实现实时更新（即往数据库中添加数据，页面的下拉选择就能够出现更新的内容）
这是因为上述创建的字段为静态字段，在程序在载时加载后就不在执行了。可以采用如下的方式解决该问题。
test_user = fields.ChoiceField(
required=False,
choices=models.User.objects.values_list("id","user")
) def __init__(self,*args,**kwargs):
super(MyForm, self).__init__(*args,**kwargs)
self.fields["test_user"].widget.choices = models.User.objects.values_list("id","user")
将字段在初始化函数中再次赋值。
另外一种解决方法是：用ModelChoiceField字段
from django.forms.models import ModelChoiceField
test_user = ModelChoiceField(
queryset=models.User.objects.all(),
to_field_name="user"
) # to_field_name="user"指定生成option的html代码的value的值。
但是这个方法得到的下拉框中内容是一个对象，要是名字要用__str__方法。并且扩展性不强。
七、对数据的验证过程和验证扩展
对数据的验证是从is_valid开始，
def is_valid(self):
"""Return True if the form has no errors, or False otherwise."""
return self.is_bound and not self.errors
@property
def errors(self):
"""Return an ErrorDict for the data provided for the form."""
if self._errors is None:#没有错误时，继续验证，在full_clean中验证
self.full_clean()
return self._errors
def full_clean(self):
"""
Clean all of self.data and populate self._errors and self.cleaned_data.
"""
self._errors = ErrorDict()
if not self.is_bound: # Stop further processing.
return
self.cleaned_data = {}
# If the form is permitted to be empty, and none of the form data has
# changed from the initial data, short circuit any validation.
if self.empty_permitted and not self.has_changed():
return self._clean_fields()
self._clean_form()
self._post_clean()
def _clean_fields(self):
#name为字段名，field是具体的字段
for name, field in self.fields.items():
# value_from_datadict() gets the data from the data dictionaries.
# Each widget type knows how to retrieve its own data, because some
# widgets split data over several HTML fields.
if field.disabled:
value = self.get_initial_for_field(field, name)
else:
value = field.widget.value_from_datadict(self.data, self.files, self.add_prefix(name))
try:
if isinstance(field, FileField):
initial = self.get_initial_for_field(field, name)
value = field.clean(value, initial)
else:
value = field.clean(value)
self.cleaned_data[name] = value
#上述是进行正则表达式的验证，当正则表达式验证通过时，将值传递到self.cleaned_data中。下面是留的验证扩展的接口
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_%s%name,函数要具有返回值；出错时，函数抛出ValidationError 异常。
如果存在较多的字段需要同时验证，在self._clean_form()中，
def _clean_form(self):
try:
cleaned_data = self.clean()#源代码中该函数没有执行任何操作，直接返回clean_data，因此源代码没有做任何处理
except ValidationError as e:
self.add_error(None, e)
else:
if cleaned_data is not None:
self.cleaned_data = cleaned_data
def clean(self):
"""
Hook for doing any extra form-wide cleaning after Field.clean() has been
called on every field. Any ValidationError raised by this method will
not be associated with a particular field; it will have a special-case
association with the field named '__all__'.
"""
return self.cleaned_data
在新建的类中，重写clean方法，可以实现对多个字段的验证，验证通过返回验证后的数据，出错时，抛出ValidationError 异常。捕捉到的异常加到错误信息中的键为__all__。
def _post_clean(self):
"""
An internal hook for performing additional cleaning after form cleaning
is complete. Used for model validation in model forms.
"""
pass
还有一个_post_clean()函数，什么也没做，可以自己写验证，但是用得较少，而且在源码中没有做任何的异常处理。