7. Django Form
7.1. Form表单
Django带有一个form库,称为django.forms,这个库可以处理上一章提到的包括HTML表单的自动生成以及数据验证。
我们在inventory目录下增加forms.py文件,与models.py文件类似,专门用来存储form类。
class ItemForm(forms.Form): ItemCode = forms.CharField() ItemName = forms.CharField() Remark = froms.CharField(required=False)
Form类创建后生成相应字段的html描述格式,Form对象还可以进行校验数据。我们创建一个新的Form象,初始化为匹配的字典类型数据。这样我们form的is_valid()方法,来确认表单数据是否合法(符合校验规则)。
>>> from inventory.forms import ItemForm >>> f=ItemForm({‘ItemCode‘: u‘005‘,‘ItemName‘:u‘螺丝钉‘}) >>> f.is_valid() True >>>
如果初始化参数留空ItemCode或ItemName,整个Form就不合法了,如下:
>>> f=ItemForm({‘ItemCode‘: u‘005‘}) >>> f.is_valid() False >>>
每一个Form实体都有一个errors属性,它为你提供了所有字段与对应错误消息相映射的字典表。
>>> f.errors {‘ItemName‘: [u‘This field is required.‘]} >>>
如果一个Form实体的数据是合法的,它就会有一个可用的cleaned_data属性。 这是一个包含干净的提交数据的字典。 Django的form框架不但校验数据,还会把它们转换成相应的Python类型数据格式。
>>> f=ItemForm({‘ItemCode‘: u‘005‘,‘ItemName‘:u‘螺丝钉‘}) >>> f.is_valid() True >>> f.cleaned_data {‘ItemCode‘: u‘005‘, ‘ItemName‘: u‘\u87ba\u4e1d\u9489‘, ‘Remark‘: u‘‘} >>>
7.2. 在视图中使用Form对象
下示例说明了我们如何用forms框架实现AddItem ():
def AddItem(request): if request.method == ‘POST‘: form = ItemForm(request.POST) if form.is_valid(): cd = form.cleaned_data item = Item() item.ItemCode = cd[‘ItemCode‘] item.ItemName = cd[‘ItemName‘] item.save() return HttpResponseRedirect(‘/success/‘) else: form = ItemForm( ) return render_to_response(‘ItemAdd.html‘, {‘form‘: form}, context_instance = RequestContext(request))
模板文件ItemAdd.html:
<html> <head> <title>Add Item</title> </head> <body> <h1>Add Item</h1> {% if form.errors %} <p style="color: red;"> Please correct the error{{ form.errors|pluralize }} below. </p> {% endif %} <form action="" method="post"> {% csrf_token %} <table> {{ form.as_table }} </table> <input type="submit" value="Submit"> </form> </body> </html>
代码看上去是多么的简洁明了,Django的forms框架处理了HTML显示、数据校验、数据清理和表单错误重现,让原来复杂的表单代码简洁了很多。下面我们简要说明forms框架可以做那些事情。
7.2.1. 改变字段显示
class ItemForm(forms.Form): ItemCode = forms.CharField() ItemName = forms.CharField() Remark = froms.CharField( widget=forms.Textarea )
7.2.2. 设置最大长度
class ItemForm(forms.Form): ItemCode = forms.CharField(max_length=10 ) ItemName = forms.CharField() Remark = froms.CharField( widget=forms.Textarea )
7.2.3. 指定标签和修改错误提示
class ItemForm(forms.Form): ItemCode = forms.CharField( max_length=10 label=u‘物料编码:‘, error_messages={‘required‘: u‘必填项‘}, ) ItemName = forms.CharField( label=u‘物料名称:‘, ) Remark = forms.CharField( required=False,widget=forms.Textarea,label=u‘备注:‘, )
7.2.4. 定制Form设计
我们可以使用CSS更精确控制表单显示,自动生成的错误列表精确的使用 <ul class=”errorlist”>`,我们就可以针对它们使用CSS,下面的CSS让错误更加醒目了:
<style type="text/css"> ul.errorlist { margin: 0; padding: 0; } .errorlist li { background-color: red; color: white; display: block; font-size: 10px; margin: 0 0 3px; padding: 4px 5px; } </style>
7.3. 使用Form类优化入库表单
下面是我们用Form类优化的入库单功能,代码如下:
class InStockBillForm(forms.Form): InStockBillCode = forms.CharField() Operator = forms.CharField() InStockDate = forms.DateTimeField() Amount = forms.IntegerField() Item = forms.ModelChoiceField(queryset = Item.objects.all(), required =True)
注意:Item属性设置成下拉选择字段类型,数据集为所有的Item对象。
def AddInStockBill(request): if request.method == ‘POST‘: form = InStockBillForm(request.POST) if form.is_valid(): cd = form.cleaned_data inStockBill = InStockBill() inStockBill.InStockBillCode = cd[‘InStockBillCode‘] inStockBill.InStockDate = cd[‘InStockDate‘] inStockBill.Amount = cd[‘Amount‘] inStockBill.Operator = cd[‘Operator‘] inStockBill.Item = cd[‘Item‘] inStockBill.save() return HttpResponseRedirect(‘/success/‘) else: form = InStockBillForm() return render_to_response(‘InStockAdd.html‘,{‘form‘: form} ,context_instance = RequestContext(request))
对比前面的AddInStockBill函数代码,会发现减少了大量的if判断语句,代码变得非常简洁易读。
模板代码如下:
<html> <head> <title>Add In Stock Bill</title> </head> <body> <h1>Add In Stock Bill</h1> {% if form.errors %} <p style="color: red;"> Please correct the error{{ form.errors|pluralize }} below. </p> {% endif %} <form action="/AddInStockBill/" method="post" > {% csrf_token %} <table> {{ form.as_table }} </table> <input type="submit" value="Submit"> </form> </body> </html>
浏览网页发现Item的下拉列表没有出现ItemName的值,在Model里增加__unicode__() 方法可以进行任何处理来返回对一个对象的字符串表示,如对象名称。
class Item(models.Model): ItemId = models.AutoField(primary_key=True) ItemCode = models.CharField(max_length=50) ItemName = models.CharField(max_length=50) Remark = models.CharField(max_length=200) def
__unicode__(self): return self.ItemName
7.4. 小结
Django表单类确实可以很大程度上简化表单的开发工作,提高了表单开发效率,其内置了大量的可自定义显示设置项目等,使用Django Form在某些使用场景会大大的减少工作量。
本章结束时,我们完成了Django的基本使用,更多Django的介绍请请参考《The Django Book》网站。
下一章节我们进入到IDE的使用,介绍2款主流的集成开发环境,而不是总是通过NotePad来进行代码编辑工作,提高开发的效率。