新手上路
Django的Form主要具备一下几大功能:javascript
- 生成HTML标签
- 验证用户数据(显示错误信息)
- HTML Form提交保留上次提交数据
- 初始化页面显示内容
经过Form验证有俩种形式html
- Form表单提交
验证、并能够保留上次内容java
- Ajax提交
验证、无需上次内容(Ajax提交数据页面不会刷新)python
返回HttpResponsegit
前面根据回调函数值相应地作出跳转或者显示错误信息正则表达式
小试牛刀
一、建立Form类数据库
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
|
# 建立一个类
from
django
import
forms
from
django.forms
import
fields
class
DiyForm(forms.Form):
# 类中建立字段 例如 IntegerField包含了正则表达式
user
=
fields.CharField(
max_length
=
18
,
min_length
=
6
,
required
=
True
,
error_messages
=
{
'max_length'
:
'用户名过长'
,
'min_length'
:
'用户名太短'
,
'required'
:
'用户名不能为空'
,
'invalid'
:
'输入类型错误'
}
)
pwd
=
fields.CharField(
required
=
True
,
min_length
=
8
,
error_messages
=
{
'required'
:
'密码不可为空'
,
'min_length'
:
'密码至少为8位'
}
)
age
=
fields.IntegerField(
required
=
True
,
error_messages
=
{
'required'
:
'年龄不可为空'
,
'invalid'
:
'年龄必须为数字'
}
)
email
=
fields.EmailField(
required
=
True
,
min_length
=
8
,
error_messages
=
{
'required'
:
'邮箱不可为空'
,
'min_length'
:
'邮箱长度不匹配'
,
'invalid'
:
'邮箱规则不符合'
}
)
|
二、View函数django
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
from
django.shortcuts
import
render,HttpResponse,redirect
def
f1(request):
if
request.method
=
=
'GET'
:
obj
=
DiyForm()
# 实例化 传参可进行模板渲染 生成Html代码
return
render(request,
'f1.html'
, {
'obj'
:obj})
else
:
obj
=
DiyForm(request.POST)
# 判断是否所有验证成功 逐一交给类字段里面一一进行验证、像一层滤网
if
obj.is_valid():
# 用户提交的数据 验证成功的信息
print
(
'验证成功'
, obj.cleaned_data)
return
redirect(
'http://www.baidu.com'
)
else
:
print
(
'验证失败'
, obj.errors)
# 封装的错误信息
return
render(request,
'f1.html'
, {
'obj'
: obj})
|
三、Html生成函数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<!DOCTYPE html>
<html lang
=
"en"
>
<head>
<meta charset
=
"UTF-8"
>
<title>DjangoForm<
/
title>
<
/
head>
<body>
<form action
=
"/f1.html"
method
=
"post"
novalidate enctype
=
"multipart/form-data"
>
<p>{{ obj.user }}{{ obj.errors.user.
0
}}<
/
p>
<p>{{ obj.pwd }}{{ obj.errors.pwd.
0
}}<
/
p>
<p>{{ obj.age }}{{ obj.errors.age.
0
}}<
/
p>
<p>{{ obj.email }}{{ obj.errors.email.
0
}}<
/
p>
<
input
type
=
"submit"
value
=
"提交"
>
<
/
form>
<
/
body>
<
/
html>
|
初露锋芒
建立Form类时,主要涉及到 【字段】 和 【插件】,字段用于对用户请求数据的验证,插件用于自动生成HTML;post
一、Django中Form类内置字段以下:
经常使用字段
1
2
3
4
5
6
7
8
9
10
11
12
13
|
用于保存正则表达式
ChoiceField
*
*
*
*
*
MultipleChoiceField
CharField
IntegerField
DecimalField
DateField
DateTimeField
EmailField
GenericIPAddressField
FileField
RegexField
|
详细字段
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
131
132
133
134
135
136
|
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类型
...
|
二、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
44
45
46
|
# 单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、
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'
)
|
方式2、
使用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())
|
更上一层楼
经过上述,Django的Form组件提供验证用户提交的数据并能够显示错误信息(或自定制),更能能够生成相应的Html代码。更是猜测到,仅仅根据Form组件的验证或许知足不了一些需求,因而创建再Form的验证功能上使其有很强的扩展性
1、基于Form组件的字段上的简单扩展
方式A
1
2
3
4
5
6
7
8
9
10
|
from
django.forms
import
Form
from
django.forms
import
widgets
from
django.forms
import
fields
from
django.core.validators
import
RegexValidator
class
MyForm(Form):
phone
=
fields.CharField(
validators
=
[RegexValidator(r
'^[0-9]+$'
,
'请输入数字'
), RegexValidator(r
'^188[0-9]+$'
,
'数字必须以188开头'
)],
)
|
方式B
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
|
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
'邮箱'
}))
|
2、基于源码执行的流程上进行扩展
方式A
例如在注册一个帐号时、经过Form的验证其帐号符合规则时,还将要判断该帐号是否存在于数据库,如存在则确定是注册不经过的
自定义方法、单一字段逐个再次验证
from Formtest import models from django import forms from django.forms import fields from django.forms import widgets from django.core.exceptions import ValidationError,NON_FIELD_ERRORS from django.core.validators import RegexValidator class AjaxForm(forms.Form): user=fields.CharField( max_length=10, required=False, validators=[RegexValidator(r'^[a-z]+$', 'Enter a valid extension.', 'invalid')], ) email=fields.EmailField() def clean_user(self): """ Form中字段中定义的格式匹配完以后,执行此方法进行验证 :return: """ v = self.cleaned_data['user'] if models.UserInfo.objects.filter(user=v).count(): raise ValidationError('此用户名已经存在') return v def clean_email(self): """ email验证过以后、能够自定义验证该邮箱是否被使用... :return: """ pass
方式B
from Formtest import models from django import forms from django.forms import fields from django.forms import widgets from django.core.exceptions import ValidationError,NON_FIELD_ERRORS from django.core.validators import RegexValidator class AjaxForm(forms.Form): user = fields.CharField( max_length=10, required=False, validators=[RegexValidator(r'^[a-z]+$', 'Enter a valid extension.', 'invalid')], ) email = fields.EmailField() def clean_user(self): """ Form中字段中定义的格式匹配完以后,执行此方法进行验证 :return: """ v = self.cleaned_data['user'] if models.UserInfo.objects.filter(user=v).count(): raise ValidationError('此用户名已经存在') return v def clean_email(self): """ email验证过以后、能够自定义验证该邮箱是否被使用... :return: """ pass def clean(self): """ 在单字段自定义验证完成以后、也能够对总体进行一个验证 :return: """ value_dict = self.cleaned_data user = value_dict.get('user') email = value_dict.get('email') if user == 'root' and email == 'root@163.com': raise ValidationError('身份验证信息验证失败') return value_dict # ps: _post_clean是clean验证完以后进一步验证操做、通常用不到 # 全局错误信息地键是 __all__