功能一:校验数据:
1.用form组件实现简单的登陆校验功能,后端返回不符合校验规则的提示信息:
views.py:
def register(request):
error_dict = {'username': '', 'password': ''}
if request.method == 'POST':
username = request.POST.get('username')
password = request.POST.get('password')
print(username,password)
if username == 'jason':
error_dict['username'] = '用户名不能为jason'
if password == '123' or '123456':
error_dict['password'] = '密码过于简单,请重新输入'
return render(request,'register.html',locals())
register.html:
<body>
<form action="" method="post">
<p>username:
<input type="text" name="username">
<span style="color: red">{{ error_dict.username }}</span>
</p>
<p>password:
<input type="text" name="password">
<span style="color: red">{{ error_dict.password }}</span>
</p>
<p>
<input type="submit">
</p>
</form>
</body>
2.form组件校验用户数据:首先在views.py中产生一个类,定义好各个字段。
from django import forms
class MyForm(forms.Form):
username = forms.CharField(min_length=2,max_length=32)
age = forms.IntegerField(min_value=0,max_value=150)
email = forms.EmailField()
在test.py中测试数据:首先生成一个对象,在类的括号中传入数据,数据以字典的形式传入,后期传入querydict。对象.is_valid()查看数据是否符合要求。
from app01 import views
form_obj = views.MyForm({'username':'max','age':25,'email':'13260676190@163.com'})
print(form_obj.is_valid()) # True
3.对象.cleaned_data可以查看符合要求的数据,对象.errors可以查看不符合的数据以及
错误原因:
form_obj1 = views.MyForm({'username':'kevin','age':18,'email':'12345'})
print(form_obj1.is_valid()) # False
print(form_obj1.cleaned_data) # {'username': 'kevin', 'age': 18}
"""
单独执行print(form_obj1.cleaned_data)会报错,需要print(form_obj1.is_valid())和print(form_obj1.cleaned_data)一起执行才可以
"""
print(form_obj1.errors) # <ul class="errorlist"><li>email<ul class="errorlist"><li>Enter a valid email address.</li></ul></li></ul>
"""
1.默认所有字段必须传值。
2.多传的会忽略不做校验。
"""
之前我们在去前端获取用户输入都要用到form表单,今天我们提供一种新的方式:
1.forms组件渲染标签的方式1:在views写一个类,也就是一个表,在里面定义好字段名,在定义一个函数,用类产生一个对象,将该对象传到前端并且用对象名.as_p的方式即可:
views.py:
from django import forms
class MyForm(forms.Form):
'''label可以控制在页面上显示的名字,如果不设置默认显示字段名首字母大写'''
username = forms.CharField(max_length=5,min_length=2,label='姓名')
age = forms.IntegerField(max_value=150,min_value=0,label='年龄')
email = forms.EmailField(label='邮箱')
def ab_forms_func(request):
form_obj = MyForm()
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{{ form_obj.as_p }}
</body>
"""
封装程度不高,扩展性差,主要用于本地测试
"""
2.依然是之前的用户对象,在前段.字段名.label就是字段名的别名,点字段名表示输入框:
<body>
<p>用户注册</p>
{# {{ form_obj.as_p }}#}
{{ form_obj.username.label }}
{{ form_obj.username }}
{{ form_obj.age.label }}
{{ form_obj.age }}
{{ form_obj.email.label }}
{# {{ form_obj.email }}#}
</body>
"""
扩展性高,但编写较为麻烦
"""
3.对form_obj进行for循环,在循环中分别格式化输出form.lable(别名)和form(输入框),推荐使用:
<body>
<p>用户注册</p>
{% for form in form_obj %}
<p>
{{ form.label }}
{{ form }}
</p>
{% endfor %}
</body>
"""
注意事项
forms组件之负责渲染获取用户数据的标签,也就意味着form标签与按钮都需要自己写。
前端的校验是弱不禁风的 最终都需要后端来校验 所以我们在使用forms组件的时候可以直接取消前端帮我们的校验:<form action="" novalidate>
"""
1.对前端发来的信息进行校验,并且展示在前端:
前端form.errors.0:拿到标签中的错误信息
views.py:
from django import forms
class MyForm(forms.Form):
username = forms.CharField(max_length=5,min_length=2,label='姓名')
age = forms.IntegerField(max_value=150,min_value=0,label='年龄')
email = forms.EmailField(label='邮箱')
def ab_forms_func(request):
form_obj = MyForm()
if request.method == 'POST':
# print(request.POST) # <QueryDict: {'username': ['max'], 'age': ['25'], 'email': ['123@pp.com'], '提交': ['提交']}>
'''MyForm()括号内需要填一个字典,正巧request.POST的到的结果就是一个字典,如果是post请求,将浏览器获取到的数据放入form_obj内,自动进行校验'''
form_obj = MyForm(request.POST)
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{# 目前只要修改form表单中的method="post",就需要在settings中注掉csrf #}
<form action="" novalidate method="post">
{% for form in form_obj %}
<p>
{{ form.label }} # 展示标签
{{ form }} # 展示数据值
'''form.errors可以查看到错误信息,如果是get请求,form_obj是空对象,点不出结果。点0代表只拿标签中的文本'''
<span>{{ form.errors.0 }}</span> # 展示错误信息
</p>
{% endfor %}
<input type="submit" name="提交">
</form>
</body>
2.如果我们想让提示信息变成中文,并且编辑其内容:
2.1需要在类中用参数error_messages来编辑错误提示内容,编辑了之后如果哪一条未遵守就会提示相应的信息:
views.py:
from django import forms
class MyForm(forms.Form):
username = forms.CharField(max_length=5,min_length=2,label='姓名',error_messages={
'max_length':'姓名不能超过5个字符!',
'min_length': '姓名最少必须2个字符!',
'required': '姓名不能为空!'
})
age = forms.IntegerField(max_value=150,min_value=0,label='年龄',error_messages={
'max_value':'年龄范围超过最大值!',
'min_value':'年龄必须是正整数!',
'required': '年龄不能为空!' # 设置为空提醒
})
email = forms.EmailField(label='邮箱',error_messages={
'required': '邮箱不能为空!',
'invalid': '邮箱格式有误!' # 设置邮箱不合法提醒
})
def ab_forms_func(request):
form_obj = MyForm()
if request.method == 'POST':
form_obj = MyForm(request.POST)
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{# 目前只要修改form表单中的method="post",就需要在settings中注掉csrf #}
<form action="" novalidate method="post">
{% for form in form_obj %}
<p>
{{ form.label }}
{{ form }}
<span style="color: red">{{ form.errors.0 }}</span>
</p>
{% endfor %}
<input type="submit" name="提交">
</form>
</body>
2.2在settings.py中导入模块:from django.conf import global_settings,ctrl+global_settings可以看到个国语言的简写,然后将LANGUAGE_CODE = 'en-us'改成其他语言简写,这样在页面中拿到的错误提示语言就是该国语言。
1.form针对字段数据的校验,提供了三种方式(可以一起使用):
1.直接写参数(max_length,min_value)
2.使用正则表达式:
在class中新加入一个字段:
from django.core.validators import RegexValidator
phone = forms.CharField(label='电话' ,validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],)
3.钩子函数(编写代码自定义校验):
2.钩子函数:是在前两部校验完成之后才会触发(钩子函数一定要定义在类中,是类中的方法,也是最后一道校验方式)。
局部钩子:每次只校验一个字段的数据(验证用户名是否已存在)
全局钩子:一次可以校验多个字段数据(校验两次密码输入是否一致)
2.1校验单个字段,函数需以clean_字段名命名,添加错误信息用self.add_error,返回值返回指定的字段名:
def clean_username(self):
'''拿到字段输入的名字'''
username = self.cleaned_data.get('username')
if username == 'jason':
'''返回错误信息'''
self.add_error('username','用户名jason已存在')
'''使用完要把变量名返回去'''
return username
2.2校验多个字段:函数以clean命名,添加错误信息用self.add_error,返回值返回所有的数据self.cleaned_data:
def clean(self):
password = self.cleaned_data.get('password')
confirm_pwd = self.cleaned_data.get('confirm_pwd')
if not password == confirm_pwd:
self.add_error('confirm_pwd', '两次密码输入不一致,请重新输入')
return self.cleaned_data
html:
<body>
<p>用户注册</p>
{# 目前只要修改form表单中的method="post",就需要在settings中注掉csrf #}
<form action="" novalidate method="post">
{% for form in form_obj %}
<p>
{{ form.label }}
{{ form }}
<span style="color: red">{{ form.errors.0 }}</span>
</p>
{% endfor %}
<input type="submit" name="提交">
</form>
</body>
"""
先执行局部钩子,再执行全局钩子
"""
min_length:最小长度
max_length:最大长度
min_value:最小值
min_value:最大值
label:自定义中文名
error_messgaes:自定义错误信息(键是字符串关键字,值是自定义提示)
validators:正则校验器
initial:给字段添加默认值
required=False:该信息允许为空;如果不填默认是required=True
widget:控制生成标签的各项属性
widget=forms.widgets.PasswordInput():密码按密文显示(需要提前导入模块:from django.forms import widgets,相当于form表单中的type='password')
widget=forms.widgets.TextInput():相当于form表单中的type='text'。
attrs={'class': 'form-control'}:添加第三方框架渲染的样式,要添加在widget=forms.widgets.TextInput()中的括号内。如果有多个类,中间用空格隔开:attrs={'class': 'form-control c1 c2'}
单选:
gender = forms.fields.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
单选下拉框:
hobby = forms.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=3,
widget=forms.widgets.Select()
)
多选下拉框:
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
单选checkbox:
keep = forms.ChoiceField(
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
多选checkbox:
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
6.Django所有内置字段
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类型
1.我们学习校验性组件的目的,绝大部分是为了数据录入数据库之前的各项审核,forms组件使用的时候需要对照模型类编写代码,不够方便。
2.models和form组件的结合体,modelform组件相较于form组件更强大。
from django import forms
from app01 import models
class MyModelForm(forms.ModelForm):
class Meta:
model = models.UserInfo
fields = '__all__'
labels = {
'username':'用户名'
}
def ab_mf_func(request):
modelform_obj = MyModelForm()
if request.method == 'POST':
modelform_obj = MyModelForm(request.POST,instance=User_obj)
if modelform_obj.is_valid():
modelform_obj.save() # models.UserInfo.objects.create(...)/update(...)
else:
print(modelform_obj.errors)
return render(request, 'modelFormPage.html', locals())
浙公网安备 33010602011771号