form组件
之前忽略了一个问题,没有对用户输入的值进行判断
- 对输入内容进行校验的目的:减少后台代码频繁的连接数据库带来的压力
- 前端和后端都要进行校验:前端js可以被禁用
django forms主要针对的是后台的校验
之前所存在的问题:
- 没有对用户的值进行校验(正则表达式校验,判断用户输入的字符长度)
- 之前是一个一个进行判断的
- 在用户输入有误后,无法保留用户上一次提交的内容
forms的基本使用
# 写一个类用于验证
# views.py
from django.forms import Form
from django.forms import fields
class LoginForm(Form):
# 用于验证的规则
# 要和form表单中的name名一致
username = fields.CharField(
required=True, # 不能为空
max_length=16, # 最大长度为16
min_length=6, # 最小长度为6
error_messages={ # 修改默认的错误信息
'required': '不能为空',
'max_length': '太长了',
'min_length': '太短了',
}
)
pwd = fields.CharField()
age = fields.IntegerField(
required=True,
max_value=100,
min_value=0,
error_messages={
"required" : '不能为空',
"invalid" : '格式错误', # 格式错误就是invalid
}
)
def login(request):
if request.method == 'GET':
return render(request, 'login.html')
else:
# username = request.POST.get('username')
# pwd = request.POST.get('pwd')
obj = LoginForm(request.POST)
print(obj) # 传来的信息
if obj.is_valid(): # 是否合法,是否合法来源于charField中的参数,不填参数就判断是否填了内容
print(obj.cleaned_data) # 对象 拿到原始的数据
else:
print(obj.errors) # 对象 拿到错误信息,打印的时候调用了 __str__,本质上还是一个对象
return render(request, 'login.html', {'obj': obj})
<!--login.html-->
<form action="/login/" method="POST">
请输入用户名:<input type="text" name="username">{{ obj.errors.username.0 }}
请输入密码:<input type="password" name="pwd">
请输入年龄:<input type="text" name="age">{{ obj.errors.age.0 }}
<input type="submit" value="提交">
</form>
forms的数据类型
Field
required=True, 是否允许为空
widget=None, HTML插件
label=None, 用于生成Label标签或显示内容
initial=None, 初始值
help_text='', 帮助信息(在标签旁边显示)
error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'}
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类型
...
示例
# views.py
from django.shortcuts import render
# Create your views here.
from django.forms import Form
from django.forms import fields
class LoginForm(Form):
### 全部都是验证的规则
username = fields.CharField(
#$### 如下参数重要
required=True,
max_length=16,
min_length=6,
error_messages = {
"required" : "不能为空",
"max_length":"太长了",
"min_length":"太短了",
},
#validators=[], # 自定义验证规则,正则表达式
## 用于生成html标签
# widget=fields.Select, #HTML插件,指定生成哪种样式的input框,select
label='用户名', # 用于生成Label标签或显示内容
# initial='hahaha', # 初始值
help_text='帮助信息', #帮助信息(在标签旁边显示)
# localize=False, # 是否支持本地化,不本地化是UTC时间,True会做一个本地化
disabled = False, # 是否可以编辑
label_suffix = ">>>" # Label内容后缀
)
pwd = fields.CharField()
age = fields.IntegerField(
required=True,
max_value=100,
min_value=0,
error_messages={
"required" : '不能为空',
"invalid" : '格式错误',
}
)
email = fields.EmailField(
error_messages={
"invalid" : '格式错误',
}
)
phone = fields.RegexField(
regex='^139\d{8}$'
)
# login的POST不变,GET需要渲染一下页面
def login(request):
if request.method == 'GET':
obj = LoginForm()
return render(request, "login.html", {"obj":obj})
else:
# username = request.POST.get('username')
# pwd = request.POST.get('pwd')
obj = LoginForm(request.POST) ## {"username":'xx', 'pwd':'xx'}传入
if obj.is_valid():
print(obj.cleaned_data) ## 对象
else:
print(obj.errors) ### 对象 __str__
return render(request, "login.html", {'obj':obj})
<!--login.html-->
<form action="/login/" method="post" novalidate>
{# username: <input type="text" name="username">{{ obj.errors.username.0 }}<br> #}
{# password: <input type="password" name="pwd">{{ obj.errors.pwd.0 }}<br>#}
{# age: <input type="text" name="age">{{ obj.errors.age.0 }}<br>#}
{# email: <input type="text" name="email">{{ obj.errors.email.0 }}<br>#}
<!--只有用以下两种方式写,上面生成标签的规则才会生效-->
<!--方式一-->
<!--{{ obj.as_p }}-->
<!--方式二-->
{{ obj.username.label }} : {{ obj.username }} {{ obj.errors.username.0 }}<br>
<input type="submit" value="提交"><br>
</form>
总结
# 使用{{ obj.as_p }} # 就是把内容用p标签包着,如果直接用{{ obj }}那就是直接生成内容
# 这些属性是用来添加标签的,不是修改标签,使用第一种方式添加的标签,前端在提示时会自动把信息放到一个框里,可以在form标签中添加novalidate去掉框,但是这样子,错误信息的位置也是无法控制的
# 使用第二种方式,label_suffix传不进来,需要自己写
# 使用这种方式的话,上一次提交的内容也不会被清除
# 但如果要对样式进行设置,需要从浏览器中用F12检查到前端自己设置的一个id,再进行css和js设置
# 自己写标签,和自动生成标签的方式可以一起使用