[Django高级之forms组件]
forms组件之校验字段
# 第一步：定义一个类,继承forms.Form
# 第二步：在类中写字段，要校验的字段，字段属性就是校验规则
# 第三步：实例化得到一个Form对象，把要校验的数据传入
# 第四步：调用 对象.is_valid()校验，校验通过就是True
可以判断是否符合定义的字段条件# 第五步：校验通过有 对象.cleaned_data
获取符合校验规则的数据# 第六步：校验不通过 对象.errors
获取不符合校验的字段、以及错误信息前戏
写一个注册页面获取用户的用户名和密码
发送到后端之后在后端完成对用户名和密码的数据校验 1.用户名里面不能含有JPZ
2.密码不能为空 将提示信息渲染到前端页面1.前端页面标签书写
2.前端页面信息展示
3.后端数据校验forms组件可以一条龙服务 帮你完成上面的三件事情
1.渲染标签
2.校验数据
3.展示信息
forms组件校验数据
1、对象 .is_valid()
2、对象 .cleaned_data
3、对象 .errors
# forms代码书写from django import formsclass MyForm(forms.Form): # username字段最少不能少于3位 最多不能超过8位
username = forms.CharField(max_length=8,min_length=3) # password字段最大值不能超过699
password = forms.IntegerField(max_value=699) # email字段必须符合邮箱格式
email = forms.EmailField()# 校验数据
from app01 import views
# 1.类加括号 传入字典即可
form_obj = views.MyForm({'username':'jason','password':'123','email':'嘿嘿嘿'})# 2.判断数据是否合法(只有全部合法结果才为True)
form_obj.is_valid()
False# 3.查看所有合法的数据
form_obj.cleaned_data
{'username': 'jason', 'password': 123}# 4.查看所有不合法的数据及原因
form_obj.errors
{'email': ['Enter a valid email address.']}"""
校验数据可以多传 但是不能少传(默认必填)
"""
校验数据可以多传 但是不能少传(默认必填)
forms组件渲染标签
def register(request):
if request.method == 'GET':
# GET请求没有数据，需要生成一个空form对象
# 这个form跟下面没有关系，是get请求过来的得到一个空form
register_form = RegisterFrom()
# 传到前端页面后，通过form进行渲染
return render(request, 'register.html', {'form': register_form})
else:
register_form = RegisterFrom(request.POST) if register_form.is_valid():
print('效验通过')
print(register_form.cleaned_data)
register_form.cleaned_data.pop('re_password')
models.User.objects.create(**register_form.cleaned_data)
else:
print('效验不通过')
print(register_form.errors) return render(request,'register.html')
渲染方式一
可扩展性强，但是需要书写的代码太多，一般情况下不用
<h2>通过form自动渲染一</h2>
<form action="" method="post">
<p>用户名 {{ form.name }}</p>
<p>密码 {{ form.password }}</p>
<p>确认密码 {{ form.re_password }}</p>
<p>邮箱 {{ form.email }}</p>
<input type="submit" value="提交"></form>
渲染方式二
推荐使用，代码书写简单，并且可扩展性强
<h2>通过form自动渲染二(基本用这种)</h2><form action="" method="post">
{% for item in form %}
<p>{{ item.label }}{{ item }}</p>
{% endfor %}
<input type="submit" value="提交"><span style="color: red">{{ error }}</span></form>
渲染方式三
代码书写极少，封装程度太高，不便于后续的扩展，一般情况下只在本地测试使用
<h2>通过form自动渲染三</h2>
<form action="" method="post">
{{ form.as_p }}
{# {{ form.as_table }}#}
{# {{ form.as_ul }}#}</form>
注意:#forms组件无法渲染提交按钮和form标签都需要你自己编写
forms组件展示提示信息
后端代码书写views.py
# 后端views中定义form类：from django import forms
# forms代码书写
class Myform(forms.Form):
# 最多8位 最少3位
username = forms.CharField(max_length=8,min_length=3,label='用户名',
error_messages={
# 自定义错误信息
'max_length':'用户名最多8位',
'min_length':'用户名最少3位',
'required':'用户名不能为空',
},
widget=widgets.TextInput(attrs={'class':'form-control'}))
# 指定字段类型
) # 最多666位
password = forms.IntegerField(max_value=666,label='密码',
error_messages={
# 自定义错误信息
'max_length': '密码最多8位',
'min_length': '密码最少3位',
'required': '密码不能为空'
},
widget=widgets.PasswordInput(attrs={'class':'form-control'}))# 指定字段类型为 password
)
confirm_password = forms.IntegerField(max_value=666, label='确认密码',
error_messages={
# 自定义错误信息
'max_length': '确认密码最多8位',
'min_length': '确认密码最少3位',
'required': '确认密码不能为空'
})
# 必须符合邮箱格式
email = forms.EmailField(label='邮箱',
error_messages={ # 自定义错误信息
'invalid':'邮箱格式不正确',
'required': '邮箱不能为空',
}) --------------------------------------------------------------------# views视图函数处理部分： def login(request):
# 1、先生成一个对象
form_obj = Myform()
# 2、判断请求方式
if request.method == 'POST': # 获取用户数据
# request.POST # 可以直接看成是一个字典
# 校验用户数据
# MyForm() # forms组件校验数据刚好需要传入一个字典
'''上述两步合一步''' # 3、校验数据 于上面对象名字必须一致
form_obj = Myform(request.POST)
# 4、判断数据是否合法
if form_obj.is_valid():
# 5、合法的话
return HttpResponse('登录成功')# 2.将该对象传递给html页面
return render(request,'login.html',locals())
前端代码书写login.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js"></script>
<link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" rel="external nofollow" rel="stylesheet">
</head>
<body>
<form action="" method="post" novalidate>
# 取消浏览器校验 novalidate {% for form in form_obj %}
<p>{{ form.label }}:{{ form }}
<span style="color: red">{{ form.errors.0 }}</span>
</p>
{% endfor %} <button class="btn btn-info">提交</button></form>
</body>
</html>
forms组件常用参数
class Ret(Form):
name = forms.CharField(max_length=10, min_length=2, label='用户名',
error_messages={
'required': '该字段不能为空',
'invalid': '格式错误',
'max_length': '太长',
'min_length': '太短'},
widget=widgets.TextInput(attrs={'class':'form-control'}))max_length最大范围
min_length最小范围
label字段文本内容
required字段是否必填 默认是True
error_messages 定义提示信息
widget定义字段类型和属性
validators额外的校验功能(一般都是正则)
initial 设置默认值
forms组件钩子函数
除了上面两种方式，我们还可以在Form类中定义钩子函数，来实现自定义的验证功能。
局部钩子:
我们在Fom类中定义 clean_字段名() 方法，就能够实现对特定字段进行校验。
全局钩子:
我们在Fom类中定义 clean() 方法，就能够实现对字段进行全局校验。
提供更加复杂的与业务相关的校验功能
钩子函数其实就在书写forms类的过程中定义方法'''钩子函数都是在数据校验的最后一个环节执行'''
--------------------------------------------------------------------------------------局部钩子(单个字段校验使用局部)# 校验当前用户名是否已存在
def clean_username(self):
# 获取用户名
username = self.cleaned_data.get('username')
# 查询数据库并判断
if username == 'jason':
# 提示用户名已存在
self.add_error('username','用户名已存在')
return username ----------------------------------------------------------------------------------- 全局钩子(多个字段校验使用全局)
# 校验密码与确认密码是否一致
def clean(self):
# 获取密码 与 确认密码
password = self.cleaned_data.get('password')
confirm_password = self.cleaned_data.get('confirm_password')
if not password == confirm_password:
self.add_error('confirm_password','两次密码不一致')
return self.cleaned_data
常用字段与插件
创建Form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成HTML;
initial
初始值，input框里面的初始值。
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三" # 设置默认值
)
pwd = forms.CharField(min_length=6, label="密码")
error_messages
重写错误信息。
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
)
pwd = forms.CharField(min_length=6, label="密码")
password
class LoginForm(forms.Form):
...
pwd = forms.CharField(
min_length=6,
label="密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'c1'}, render_value=True)
)
radioSelect
单radio值为字符串
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
)
pwd = forms.CharField(min_length=6, label="密码")
gender = forms.fields.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
单选Select
class LoginForm(forms.Form):
...
hobby = forms.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=3,
widget=forms.widgets.Select()
)
多选Select
class LoginForm(forms.Form):
...
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
单选checkbox
class LoginForm(forms.Form):
...
keep = forms.ChoiceField(
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
多选checkbox
class LoginForm(forms.Form):
...
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
choice字段注意事项
在使用选择标签时，需要注意choices的选项可以配置从数据库中获取，但是由于是静态字段 获取的值无法实时更新，需要重写构造方法从而实现choice实时更新。
方式一：
from django.forms import Form
from django.forms import widgets
from django.forms import fieldsclass 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'].choices = ((1, '上海'), (2, '北京'),)
# 或
self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')
方式二：
from django import forms
from django.forms import fields
from django.forms import models as form_modelclass FInfo(forms.Form):
authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all()) # 多选
# authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all()) # 单选
