Form表单验证
Django核心功能组件之一,虽然也可以在前端使用JS对表单验证, 但是Django中已经为我们准备好的Form功能还算是很强大的,有时候比较适合运维,为我们简化了很多前端开发工作。
Django最主要的几个功能有4个 · 生成HTML标签
· 验证数据(表单错误信息提示)
· HTML 表单保留上次提交数据
· 初始化页面表单内容
Django的Form内容还是挺多的,我们可以从一个简单的登陆验证例子来看看Form的基本功能使用
1)新建URL 1
2
3
| urlpatterns = [
url(r'^fm/$', views.fm),
]
|
2)views视图里创建FM类
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
| from django import forms
from django.forms import widgets
from django.forms import fields
// FM继承forms.Form
class FM(forms.Form):
// 用户名字段
user = fields.CharField(
error_messages={'required': '用户名不能为空.'},
widget=widgets.TextInput(attrs={'class': 'c1'}),
label="用户名",
)
// 密码字段
pwd = fields.CharField(
max_length=12,
min_length=6,
error_messages={'required': '密码不能为空.', 'min_length': '密码长度不能小于6', "max_length": '密码长度不能大于12'},
widget=widgets.PasswordInput(attrs={'class': 'c2'}),
label="密码"
)
// 邮箱字段
email = fields.EmailField(error_messages={'required': '邮箱不能为空.','invalid':"邮箱格式错误"},label="邮箱")
// select字段
city1 = fields.ChoiceField(
choices=[(0,'上海'),(1,'广州'),(2,'北京')],label="城市")
|
3)views中创建fm函数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| def fm(request):
if request.method == 'GET':
// 实例化我们创建的FM类
obj = FM()
return render(request, 'fm.html', {'obj': obj})
elif request.method == 'POST':
// 如果是POST请求 需要以request.POST为参数
obj = FM(request.POST)
ret = obj.is_valid()
if ret:
print(ret)
else:
return render(request, 'fm.html', {'obj': obj})
return render(request, 'fm.html')
|
4)编辑HTML页面模版 1
2
3
4
5
6
7
8
9
10
11
| <body>
<form action="/fm/" method="POST">
{% csrf_token %}
// obj对象在前端可以直接用点取后面的字典值
<p>{{ obj.user.label }} {{ obj.user }} {{ obj.errors.user.0 }}</p>
<p>{{ obj.pwd.label }} {{ obj.pwd }} {{ obj.errors.pwd.0 }}</p>
<p>{{ obj.email.label }} {{ obj.email }}{{ obj.errors.email.0 }}</p>
{{ obj.city1.label }} {{ obj.city1 }}
<input type="submit" value="提交" />
</form>
</body>
|
5)运行程序看前端显示页面 Django已经为我们创建好了HTML代码
6)当提交表单验证数据有效性 7)初始化HTML
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| def fm(request):
if request.method == 'GET':
dic = {
"user": 'root',
'pwd': '123456',
'email': 'root@root.com',
'city1': 2,
}
// 使用inital初始化我们查询到的dic数据
obj = FM(initial=dic)
return render(request, 'fm.html', {'obj': obj})
elif request.method == 'POST':
obj = FM(request.POST)
ret = obj.is_valid()
if ret:
print(ret)
else:
return render(request, 'fm.html', {'obj': obj})
return render(request, 'fm.html')
|
初始化完成
Form类 创建Form时,主要涉及到【字段】和【插件】,字段用于对用户请求数据的验证,插件用于自动生成HTML;
1)Django内置字段
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
| // 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类型
...
|
2)Django内置插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
| 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
|
常用选择插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
| // 单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
)
|
在使用选择标签时,需要注意choices的选项可以从数据库中获取,但是由于是静态字段 ***获取的值无法实时更新***,那么需要自定义构造方法从而达到此目的。 方式一: 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
class MyForm(Form):
user = fields.ChoiceField(
# choices=((1, '上海'), (2, '北京'),),
initial=2,
widget=widgets.Select
)
def __init__(self, *args, **kwargs):
super(MyForm,self).__init__(*args, **kwargs)
# self.fields['user'].widget.choices = ((1, '上海'), (2, '北京'),)
# 或
self.fields['user'].widget.choices = models.Classes.objects.all().value_list('id','caption')
|
方式二: 使用django提供的ModelChoiceField和ModelMultipleChoiceField字段来实现 1
2
3
4
5
6
7
8
9
10
| from django import forms
from django.forms import fields
from django.forms import widgets
from django.forms import models as form_model
from django.core.exceptions import ValidationError
from django.core.validators import RegexValidator
class FInfo(forms.Form):
authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())
# authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())
|
自定义验证规则 方式一: 1
2
3
4
5
6
7
8
9
| from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
class MyForm(Form):
user = fields.CharField(
validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
)
|
方式二: 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
| import re
from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.exceptions import ValidationError
// 自定义验证规则
def mobile_validate(value):
mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
if not mobile_re.match(value):
raise ValidationError('手机号码格式错误')
class PublishForm(Form):
title = fields.CharField(max_length=20,
min_length=5,
error_messages={'required': '标题不能为空',
'min_length': '标题最少为5个字符',
'max_length': '标题最多为20个字符'},
widget=widgets.TextInput(attrs={'class': "form-control",
'placeholder': '标题5-20个字符'}))
// 使用自定义验证规则
phone = fields.CharField(validators=[mobile_validate, ],
error_messages={'required': '手机不能为空'},
widget=widgets.TextInput(attrs={'class': "form-control",
'placeholder': u'手机号码'}))
email = fields.EmailField(required=False,
error_messages={'required': u'邮箱不能为空','invalid': u'邮箱格式错误'},
widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'邮箱'}))
|
|