一篇文章浅析Django Form组件相关知识

前言

在上一篇时，我们小试牛刀了以下Django Form组件的使用，一篇文章带你了解Django Form组件(入门篇)，没来得及的小伙伴可以一起看看。但是你可能会有很多疑问，并不知道怎么使用。

并且知道Form组件的功能。

• 生成HTML标签。
• 验证提交的数据。
• 保留提交之前的数据。

所以本篇就接着上次的继续,来一起学习以下Django Form组件如何使用。

Form组件的理解

没有使用Form组件时

在一般情况下，我们如果编写输入框时，在Html中，一般都是这样写的。

代码

1. ... 
2. <form method="post" action="" novalidate> 
3.     <div> 
4.         <label>用户名:</label> 
5.         <input type="text" name="uname"> 
6.     </div> 
7.     <div> 
8.         <label>密码:</label> 
9.         <input type="text" name="upwd"> 
10.     </div> 
11.     <div><input type="submit"></div> 
12. </form> 
13. ... 

实现效果

使用Form组件时

在使用Form组件时，我们通常需要定义Form类。

这个Form，里面的字段，就可以理解为input标签，只不过是在后端写的。

Form类

1. from django.forms import Form 
2. class LoginForm(Form): 
3.     uname = fields.CharField(label="用户名") 
4.     upwd = fields.CharField(label="密码") 

views.py

1. from django.shortcuts import render 
2. def login(request): 
3.     form = LoginForm() 
4.     return render(request, "login_f.html", {"form": form}) 

html

1. ... 
2. <form method="post" action="" novalidate> 
3.     <div> 
4.         <label>{{ form.uname.label }}:</label> 
5.         {{ form.uname }} 
6.         <!--  
7.             form.uname.errors.0 是为了展示填写不正确的错误信息 
8.             errors.0是因为错误可能有多个 
9.             但是通常情况下,取第一个错误足够 
10.          --> 
11.         {{ form.uname.errors.0 }} 
12.     </div> 
13.     <div> 
14.         <label>{{ form.upwd.label }}:</label> 
15.         {{ form.upwd }} 
16.         {{ form.upwd.errors.0 }} 
17.     </div> 
18.     <div><input type="submit"></div> 
19. </form> 
20. ... 

小总结

可以发现，我并没有写input代码，而是直接调用后端的form.<字段名>出来的。

Form类生成的Html

可以发现，基本上和自己写的Html差不多，生成的id为id+<字段名>。

Form生成的Html和手动写Html对应图

通过对应图确定，通过后端的form.<字段>生成的直接就是input标签。

好了，到这，就确定了Form类，就是为我们生成input标签的。

Form使用

使用有以下步骤。

1.创建Form类,尽可能和models对上。

1. class LoginForm(Form): 
2.     uname = fields.CharField(label="用户名") 
3.     upwd = fields.CharField(label="密码") 

因为Form提交的数据，可以转换成dict,key就是Form字段名。

如果Form字段和models对上，直接models.<模型类>.objects.create(**dict)。

2.如果是GET请求，实例化Form对象，并且返回页面。

1. def login(request): 
2.     if request.method == 'GET': 
3.         form = LoginForm() 
4.         return render(request, "login_f.html", {"form": form}) 

3.如果是POST请求，实例化Form对象时，传入request.POST,request.FILES,并且验证。

1. # 接着上面 
2.     elif request.method == "POST": 
3.         form = LoginForm(request.POST, request.FILES) 
4.         ########### 验证数据 
5.         if form.is_valid(): 
6.             # 验证成功 
7.             # 验证成功之后的数据,key就是Form类的字段名 
8.             print(form.cleaned_data)  # {'uname': '1212', 'upwd': '1212'} 
9.             return HttpResponse("ok") 
10.         # 验证失败 
11.         # 虽然返回的还是页面 
12.         # 但是form会把上次输入框内容保存下来,并且还会展示errors信息 
13.         return render(request, "login_f.html", {"form": form}) 

4.前端使用后端传过来的form对象。

方式一，点每个字段

1. <form method="post" action="" novalidate> 
2.     <div> 
3.         <!-- form.uname.label点的是label属性  --> 
4.         <label>{{ form.uname.label }}:</label> 
5.         {{ form.uname }} 
6.         <!-- 
7.             form.uname.errors.0 是为了展示填写不正确的错误信息 
8.             errors.0是因为错误可能有多个 
9.             但是通常情况下,取第一个错误足够 
10.          --> 
11.         {{ form.uname.errors.0 }} 
12.     </div> 
13.     <div> 
14.         <label>{{ form.upwd.label }}:</label> 
15.         {{ form.upwd }} 
16.         {{ form.upwd.errors.0 }} 
17.     </div> 
18.     <div><input type="submit"></div> 
19. </form> 

方式二，循环form对象

form对象是可以循环的，循环的每个form对象就是每个字段对象。

1. <form method="post" action="" novalidate> 
2.     {% for foo in form %} 
3.         <div> 
4.             <label>{{ foo.label }}:</label> 
5.             {{ foo }} 
6.             {{ foo.errors.0 }} 
7.         </div> 
8.     {% endfor %} 
9.     <div><input type="submit"></div> 
10. </form> 

 所以，如果一个表有很多的字段时，尽可能的采用循环方式。

Form字段

Form组件主要是帮助我们做验证的，所以，当然有很多参数比如:

• 否可以为空。
• label展示的内容。
• 等...

常用字段

Field类为所有字段的基类

Field参数如下

• required=True,是否允许为空,默认True,不能为空
• widget=None,插件,展示的input具体信息
• label=None,label,标签展示的内容
• help_text="",帮助信息(在标签旁边显示)
• error_massages=None,错误信息{"required":"不能为空",...}
• show_hidden_initial=False,是否在当前插件后再加一个隐藏且具有默认值的插件(可用于验证两次输入是否一致)
• validators=[],自定义验证规则函数
• localize=False,是否支持本地化
• disabled=False,是否可以编辑
• label_suffix=None,Label内容后缀

CharField(Field),比较常用的字段之一

• min_length=None,最小长度
• max_length=None,最大长度
• strip=True,是否移除输入空白

IntegerField(Field)

• max_value=None,最大值
• min_value=None,最小值

DecimalField(IntegerField)

• max_value=None,最大值
• min_value=None,最小值
• max_digits=None,最大长度
• decimal_places=None,小数位长度

其他字段还有

1. BaseTemporalField(Field) 
2. DateField(BaseTemporalField) 
3. TimeField(BaseTemporalField) 
4. DateTimeField(BaseTemporalField) 
5. DurationField(Field) 
6. RegexField(CharField) 
7. EmailField(CharField) 
8. FileField(Field) 
9. ImageField(FileField) 
10. URLField(Field) 
11. BooleanField(Field) 
12. NullBooleanField(BooleanField) 

...还有很多字段，这里就不一一赘述了，具体详见官网:

https://docs.djangoproject.com/zh-hans/2.0/ref/forms/api/#django.forms.BoundField

多选字段

1. ChoiceField(Field) 
2. ... 
3.     choices=() # 选项,如:choices = ((1,'一班'),(2,'二班'),) 
4.     required=True # 是否必填 
5.     widget=None # 插件，默认select插件 
6.     label=None # Label内容 
7.     initial=None # 初始值 
8.     help_text='' # 帮助提示 
9.  
10. from django.forms.models import ModelChoiceField 
11. # 单选 
12. ModelChoiceField(ChoiceField) 
13.     queryset=None # 查询数据库中的数据 
14.     empty_label="---------" # 默认空显示内容 
15.     to_field_name=None # HTML中value的值对应的字段 
16.     limit_choices_to=None # ModelForm中对queryset二次筛选 
17. # 多选 
18. from django.forms.models import ModelMultipleChoiceField 
19. ModelMultipleChoiceField(ModelChoiceField) 
20. ... 

widget参数对应的插件

即使字段是CharField,但是最终效果以插件为主!

1. TextInput(Input) 
2. NumberInput(TextInput) 
3. EmailInput(TextInput) 
4. URLInput(TextInput) 
5. PasswordInput(TextInput) 
6. HiddenInput(TextInput) 
7. Textarea(Widget) 
8. DateInput(DateTimeBaseInput) 
9. DateTimeInput(DateTimeBaseInput) 
10. TimeInput(DateTimeBaseInput) 
11. CheckboxInput 
12. Select 
13. NullBooleanSelect 
14. SelectMultiple 
15. RadioSelect 
16. CheckboxSelectMultiple 
17. FileInput 
18. ClearableFileInput 
19. MultipleHiddenInput 
20. SplitDateTimeWidget 
21. SplitHiddenDateTimeWidget 
22. SelectDateWidget 

widget示例

1. from django.forms import fields, widgets 
2. from django.forms import Form 
3. user = fields.CharField( 
4.     initial=2, 
5.     widget=widgets.RadioSelect(choices=((1,'一班'),(2,'二班'),)) 
6. ) 
7. # or 
8. user = fields.ChoiceField( 
9.     choices=((1,'一班'),(2,'二班'),), 
10.     initial=2, 
11.     widget=widgets.RadioSelect 
12. ) 
13. # 多选select，值为列表 
14. user = fields.MultipleChoiceField( 
15.     choices=((1,'一班'),(2,'二班'),), 
16.     initial=[1,], 
17.     widget=widgets.SelectMultiple 
18. ) 
19. # 从数据库中获取多选 
20. # 方式一 
21. from django.forms import Form 
22. from django.core.validators import RegexValidator 
23.   
24. class Form类(Form): 
25.   
26.     user = fields.ChoiceField( 
27.         # choices=((1,'一班'),(2,'二班'),), 
28.         initial=2, 
29.         widget=widgets.Select 
30.     ) 
31.   
32.     def __init__(self, *args, **kwargs): 
33.         super(MyForm,self).__init__(*args, **kwargs) 
34.         # self.fields['user'].widget.choices = ((1,'一班'),(2,'二班'),) 
35.         # 或 
36.         self.fields['user'].widget.choices = models.Classes.objects.all().value_list('id','caption') 
37. # 方式二 
38. from django.forms import models as form_model 
39. class Form类(Form): 
40.     depart = form_model.ModelMultipleChoiceField(queryset=models.Depart.objects.all()) 

总结

本篇先从入门角度说如何使用简单使用Django Form组件，使用Form组件和没使用Form组件的区别。

然后讲了以下Form如何使用。

• 首先GET请求时，返回页面。
• POST请求时，验证数据，判断是否符合规则。
• 如果失败返回错误信息，如果成功继续，写入数据库。

最后列举出常用的Form字段，还有如何使用多选字段。

原文地址：https://mp.weixin.qq.com/s/4nXTsJAbYHP3LTcJHZHkFQ