Forms组件的使用
在html表单验证中,需要通过各种信息的验证,比如注册界面的姓名、密码、邮箱、电话等的验证,是否符合定义好的规则,不可能每次都要取出对应的字段一一判断,django内置了Forms组件,可以方便的在HTML中进行校验等信息设置
1.Forms组件的作用
1.数据校验
2.渲染页面
3.渲染错误信息
4.使用局部或者全局的钩子函数
5.设置CSS样式
2.Forms组件的使用
- 1.导入froms模块
from django import forms
- 2.定义一个类继承自forms.Form,编写校验的字段,该字段就是html页面上提交数据上传的字段
class RegisterForms(Form):# 添加的字段类型中的属性,每个子类都继承自field,#field中对应的属性和释义#required=True, 是否是必须验证,默认为True#widget=None, HTML插件,添加类名,设置placeholder等等#label=None, 用于生成Label标签或显示内容#initial=None, 初始值#help_text='', 帮助信息(在标签旁边显示)#error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'}#validators=[], 自定义验证规则#localize=False, 是否支持本地化#disabled=False, 是否可以编辑#label_suffix=None Label内容后缀name = forms.CharField(min_length=3,max_length=8,label="用户名",error_messages={'min_length':'用户名最少为3位','max_length':'用户名最多8位','required':'名称不能为空'})pwd = forms.CharField(min_length=6, max_length=20,label='请输入密码',error_messages={'min_length':'密码最少为6位','max_length':'密码最多20位','required':'密码不能为空'})re_pwd = forms.CharField(min_length=6, max_length=20,label='请确认密码',error_messages={'min_length':'密码最少为6位','max_length':'密码最多20位','required':'密码不能为空'})phone = forms.CharField(label="请输入手机号码",error_messages={'placerholder': '请输入手机号码'})email = forms.EmailField(label='请输入邮箱',required=False,error_messages={'invalid':'邮箱格式不合法','max_length':'密码最多20位'})
# 对于多传的字段不会出错,cleaned_data中不包含多传的字段
# 少传的字段会报错,相当于对应的字段没有值
- 3.在对应的views视图中进行校验,
def form_index(request):post_forms = RegisterForms()error = ''if request.method == 'POST':post_forms = RegisterForms(request.POST)# 4 调用forms的is_valid方法,完成校验,is_valid返回true或者falseif post_forms():register = post_forms.cleaned_dataprint(register)return HttpResponse('注册成功')else:from django.forms.utils import ErrorDict# 获取全局的error信息,只显示第一个if post_forms.errors.get('__all__'):error = post_forms.errors.get('__all__')[0]return render(request, 'FormsTest/forms_index.html',locals())
- 4.通过模板渲染,渲染模板有如下几种方式,具体使用如下
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>forms登录</title>{% load static %}<link rel="stylesheet" href="{% static 'bootstrap-3.3.7-dist/css/bootstrap.min.css' %}"><script src="{% static 'jquery-3.3.1.js' %}"></script><style>.edit-author{margin: 100px 300px;}.errorinfo{color: red;font-size: 15px;padding-left: 15px;}</style>
</head>
<body><div class="edit-author">
{# <form action="" method="post">#}
{# {% csrf_token %}#}
{# <div class="form-group">#}
{# <label for="exampleInputEmail1">用户名</label>#}
{# <input type="text" name="name" class="form-control" placeholder="请输入用户名" >#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">密码</label>#}
{# <input type="password" name="pwd" class="form-control" placeholder="请输入密码">#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">确认密码</label>#}
{# <input type="password" name="re_pwd" class="form-control" placeholder="请确认密码">#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">邮箱</label>#}
{# <input type="email" name="email" class="form-control" placeholder="请输入邮箱">#}
{# </div>#}
{##}
{# <button type="submit" id="clickBtn" class="btn btn-default submit-button">注册</button>#}
{# <span id="error"></span>#}
{# </form>#}{# forms渲染页面第一种方式#}
{# <form action="" method="post">#}
{# {% csrf_token %}#}
{# <div class="form-group">#}
{# <label for="exampleInputEmail1">用户名</label>#}
{# {{ post_forms.name }}#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">密码</label>#}
{# {{ post_forms.pwd }}#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">确认密码</label>#}
{# {{ post_forms.re_pwd }}#}
{# </div>#}
{# <div class="form-group">#}
{# <label for="exampleInputPassword1">邮箱</label>#}
{# {{ post_forms.email }}#}
{# </div>#}
{# <button type="submit" id="clickBtn" class="btn btn-default submit-button">注册</button>#}
{# </form>#}{# forms渲染页面第二种方式,推荐使用#}<form action="" method="post" novalidate>{% csrf_token %}{% for foo in reg_forms %}<div class="form-group">{# errors是一个列表,一般取第一个就可以了,这样不会换行处理#}<label for="exampleInputEmail1">{{ foo.label }}</label><span class="errorinfo"> {{ foo.errors.0 }}</span>{{ foo }}</div>{% endfor %}<button type="submit" id="clickBtn" class="btn btn-default submit-button">注册</button><span class="errorinfo">{{ error }} </span></form>{# forms渲染页面第二种方式,不推荐使用#}
{# <form action="" method="post">#}
{# {% csrf_token %}#}
{# {{ post_forms.as_p }}#}
{# {{ post_forms.as_ul }}#}
{# {{ post_forms.as_table }}#}
{# <button type="submit" id="clickBtn" class="btn btn-default submit-button">注册</button>#}
{# </form>#}</div></body>
</html>
- 5.上面只是实现了部分的校验,而且展示的样式需要手动渲染,我们可以在定义模型的时候直接设置好对应的css展示样式和自定义校验规则,比如电话号码的正则校验等等
#导入widgets模块,设置css的展示样式
from django.forms import widgets#接下来修改对应的name,pwd,phone等字段,添加新属性,如下添加了占位符和类名这个时候的登录界面就和上面的一样name = forms.CharField(min_length=3,max_length=8,label="用户名",widget=widgets.TextInput(attrs={'class': 'form-control','placeholder': '请输入名称(3-8字符)'}),error_messages={'min_length':'用户名最少为3位','max_length':'用户名最多8位','required':'名称不能为空'})pwd = forms.CharField(min_length=6, max_length=20,label='请输入密码',widget=widgets.PasswordInput(attrs={'class':'form-control','placeholder':'请输入密码(6-20字符)'}),error_messages={'min_length':'密码最少为6位','max_length':'密码最多20位','required':'密码不能为空'})re_pwd = forms.CharField(min_length=6, max_length=20,label='请确认密码',widget=widgets.PasswordInput(attrs={'class': 'form-control','placeholder': '请确认密码'}),error_messages={'min_length':'密码最少为6位','max_length':'密码最多20位','required':'密码不能为空'})phone = forms.CharField(label="请输入手机号码",widget=widgets.TextInput(attrs={'class': 'form-control','placeholder': '请输入手机号码'}),error_messages={'placerholder': '请输入手机号码'})email = forms.EmailField(label='请输入邮箱',required=False,widget=widgets.TextInput(attrs={'class': 'form-control','placeholder': '请输入邮箱'}),error_messages={'invalid':'邮箱格式不合法','max_length':'密码最多20位'})
- 6.自定义校验规则,有时django自带的校验并不能满足我们所有的需求,比如校验密码输入,不能用特殊字符,手机号码格式定义正则等,这就需要我们自定义规则
#自定义校验规则
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('手机号码格式错误')#在定义字段的时候添加校验规则,校验规则传入的是一个列表,可以有多个校验规则
phone = forms.CharField(label="请输入手机号码",validators=[mobile_validate,],widget=widgets.TextInput(attrs={'class': 'form-control','placeholder': '请输入手机号码'}),error_messages={'placerholder': '请输入手机号码'})
- 7.自定义钩子,实现自定义的错误提示和校验规则,
#Django中钩子分为局部钩子和全局钩子,
# 局部钩子函数(某个字段,自定义的规则,数据库是否存在,以什么开头)
# 方法名必须为:clean_字段名
def clean_name(self):#获取到当前对象,是cleaned_data之后的数据name = self.cleaned_data.get('name')if name.startswith('sb'):#以sb开头了返回错误信息,禁止使用sb开头的用户名raise ValidationError('不能以sb开头')# 数据库中查询有没有这个名称user = models.UserInfo.objects.filter(username=name).first()if user:raise ValidationError('用户名已存在')return name#全局钩子,方法名必须是clean
#校验两次密码是否相同等,
def clean(self):pwd = self.cleaned_data.get('pwd')re_pwd = self.cleaned_data.get('re_pwd')if pwd == re_pwd:return self.cleaned_dataelse:raise ValidationError('两次密码不一致')