Django组件-forms组件
----
用表单验证数据
常用的Field：
使用 Field 可以是对数据验证的第一步。你期望这个提交上来的数据是什么类型，那么就使用什
么类型的 Field 。
CharField：
用来接收文本。
参数：
max_length：这个字段值的最大长度。
min_length：这个字段值的最小长度。
required：这个字段是否是必须的。默认是必须的。
error_messages：在某个条件验证失败的时候，给出错误信息。
EmailField：
用来接收邮件，会自动验证邮件是否合法。
错误信息的key： required 、 invalid 。
FloatField：
用来接收浮点类型，并且如果验证通过后，会将这个字段的值转换为浮点类型。
参数：
max_value：最大的值。
min_value：最小的值。
错误信息的key： required 、 invalid 、 max_value 、 min_value 。
IntegerField：
用来接收整形，并且验证通过后，会将这个字段的值转换为整形。
参数：
max_value：最大的值。
min_value：最小的值。
错误信息的key： required 、 invalid 、 max_value 、 min_value 。
URLField：
用来接收 url 格式的字符串。
错误信息的key： required 、 invalid 。
常用验证器：
在验证某个字段的时候，可以传递一个 validators 参数用来指定验证器，进一步对数据进行过
滤。验证器有很多，但是很多验证器我们其实已经通过这个 Field 或者一些参数就可以指定了。
比如 EmailValidator ，我们可以通过 EmailField 来指定，比如 MaxValueValidator ，我们可以
通过 max_value 参数来指定。以下是一些常用的验证器：
1. MaxValueValidator ：验证最大值。
2. MinValueValidator ：验证最小值。
3. MinLengthValidator ：验证最小长度。
4. MaxLengthValidator ：验证最大长度。
5. EmailValidator ：验证是否是邮箱格式。
6. URLValidator ：验证是否是 URL 格式。
7. RegexValidator ：如果还需要更加复杂的验证，那么我们可以通过正则表达式的验证
器： RegexValidator 。比如现在要验证手机号码是否合格，那么我们可以通过以下代码实
现：
class MyForm(forms.Form):
telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d
{9}",message='请输入正确格式的手机号码！')])
自定义验证：
有时候对一个字段验证，不是一个长度，一个正则表达式能够写清楚的，还需要一些其他复杂的逻
辑，那么我们可以对某个字段，进行自定义的验证。比如在注册的表单验证中，我们想要验证手机
号码是否已经被注册过了，那么这时候就需要在数据库中进行判断才知道。对某个字段进行自定义
的验证方式是，定义一个方法，这个方法的名字定义规则是： clean_fieldname 。如果验证失
败，那么就抛出一个验证错误。比如要验证用户表中手机号码之前是否在数据库中存在，那么可以
通过以下代码实现：
class MyForm(forms.Form):
telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}",
message='请输入正确格式的手机号码！')])
def clean_telephone(self):
telephone = self.cleaned_data.get('telephone')
exists = User.objects.filter(telephone=telephone).exists()
if exists:
raise forms.ValidationError("手机号码已经存在！")
return telephone
以上是对某个字段进行验证，如果验证数据的时候，需要针对多个字段进行验证，那么可以重
写 clean 方法。比如要在注册的时候，要判断提交的两个密码是否相等。那么可以使用以下代码
来完成：
class MyForm(forms.Form):
telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}",
message='请输入正确格式的手机号码！')])
pwd1 = forms.CharField(max_length=12)
pwd2 = forms.CharField(max_length=12)
def clean(self):
cleaned_data = super().clean()
pwd1 = cleaned_data.get('pwd1')
pwd2 = cleaned_data.get('pwd2')
if pwd1 != pwd2:
raise forms.ValidationError('两个密码不一致！')
提取错误信息：
如果验证失败了，那么有一些错误信息是我们需要传给前端的。这时候我们可以通过以下属性来获
取：
1. form.errors ：这个属性获取的错误信息是一个包含了 html 标签的错误信息。
2. form.errors.get_json_data() ：这个方法获取到的是一个字典类型的错误信息。将某个字段
的名字作为 key ，错误信息作为值的一个字典。
3. form.as_json() ：这个方法是将 form.get_json_data() 返回的字典 dump 成 json 格式的字
符串，方便进行传输。
4. 上述方法获取的字段的错误值，都是一个比较复杂的数据。比如以下：
{'username': [{'message': 'Enter a valid URL.', 'code': 'invalid'}, {'message': 'Ensure
this value has at most 4 characters (it has 22).', 'code': 'max_length'}]}
那么如果我只想把错误信息放在一个列表中，而不要再放在一个字典中。这时候我们可以定义一个
方法，把这个数据重新整理一份。实例代码如下：
class MyForm(forms.Form):
username = forms.URLField(max_length=4)
def get_errors(self):
errors = self.errors.get_json_data()
new_errors = {}
for key,message_dicts in errors.items():
messages = []
for message in message_dicts:
messages.append(message['message'])
new_errors[key] = messages
return new_errors
这样就可以把某个字段所有的错误信息直接放在这个列表中。
ModelForm：
大家在写表单的时候，会发现表单中的 Field 和模型中的 Field 基本上是一模一样的，而且表单
中需要验证的数据，也就是我们模型中需要保存的。那么这时候我们就可以将模型中的字段和表单
中的字段进行绑定。
比如现在有个 Article 的模型。示例代码如下：
from django.db import models
from django.core import validators
class Article(models.Model):
title = models.CharField(max_length=10,validators=[validators.MinLengthValidator(li
mit_value=3)])
content = models.TextField()
author = models.CharField(max_length=100)
category = models.CharField(max_length=100)
create_time = models.DateTimeField(auto_now_add=True)
那么在写表单的时候，就不需要把 Article 模型中所有的字段都一个个重复写一遍了。示例代码
如下：
from django import forms
class MyForm(forms.ModelForm):
class Meta:
model = Article
fields = "__all__"
MyForm 是继承自 forms.ModelForm ，然后在表单中定义了一个 Meta 类，在 Meta 类中指定
了 model=Article ，以及 fields="__all__" ，这样就可以将 Article 模型中所有的字段都复制过
来，进行验证。如果只想针对其中几个字段进行验证，那么可以给 fields 指定一个列表，将需要
的字段写进去。比如只想验证 title 和 content ，那么可以使用以下代码实现：
from django import forms
class MyForm(forms.ModelForm):
class Meta:
model = Article
fields = ['title','content']
如果要验证的字段比较多，只是除了少数几个字段不需要验证，那么可以使用 exclude 来代
替 fields 。比如我不想验证 category ，那么示例代码如下：
class MyForm(forms.ModelForm):
class Meta:
model = Article
exclude = ['category']
自定义错误消息：
使用 ModelForm ，因为字段都不是在表单中定义的，而是在模型中定义的，因此一些错误消息无
法在字段中定义。那么这时候可以在 Meta 类中，定义 error_messages ，然后把相应的错误消息
写到里面去。示例代码如下：
class MyForm(forms.ModelForm):
class Meta:
model = Article
exclude = ['category']
error_messages ={
'title':{
'max_length': '最多不能超过10个字符！',
'min_length': '最少不能少于3个字符！'
},
'content': {
'required': '必须输入content！',
}
}
save方法：
ModelForm 还有 save 方法，可以在验证完成后直接调用 save 方法，就可以将这个数据保存到数
据库中了。示例代码如下：
form = MyForm(request.POST)
if form.is_valid():
form.save()
return HttpResponse('succes')
else:
print(form.get_errors())
return HttpResponse('fail')
这个方法必须要在 clean 没有问题后才能使用，如果在 clean 之前使用，会抛出异常。另外，我
们在调用 save 方法的时候，如果传入一个 commit=False ，那么只会生成这个模型的对象，而不
会把这个对象真正的插入到数据库中。比如表单上验证的字段没有包含模型中所有的字段，这时候
就可以先创建对象，再根据填充其他字段，把所有字段的值都补充完成后，再保存到数据库中。示
例代码如下：
form = MyForm(request.POST)
if form.is_valid():
article = form.save(commit=False)
article.category = 'Python'
article.save()
return HttpResponse('succes')
else:
print(form.get_errors())
return HttpResponse('fail')
forms组件
校验字段功能
针对一个实例：注册用户讲解。
模型：models.py
class UserInfo(models.Model):
name=models.CharField(max_length=32)
pwd=models.CharField(max_length=32)
email=models.EmailField()
tel=models.CharField(max_length=32)
模板: register.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<form action="" method="post">
{% csrf_token %}
<div>
<label for="user">用户名</label>
<p><input type="text" name="name" id="name"></p>
</div>
<div>
<label for="pwd">密码</label>
<p><input type="password" name="pwd" id="pwd"></p>
</div>
<div>
<label for="r_pwd">确认密码</label>
<p><input type="password" name="r_pwd" id="r_pwd"></p>
</div>
<div>
<label for="email">邮箱</label>
<p><input type="text" name="email" id="email"></p>
</div>
<input type="submit">
</form>
</body>
</html>
视图函数：register
# forms组件
from django.forms import widgets
wid_01=widgets.TextInput(attrs={"class":"form-control"})
wid_02=widgets.PasswordInput(attrs={"class":"form-control"})
class UserForm(forms.Form):
name=forms.CharField(max_length=32,
widget=wid_01
)
pwd=forms.CharField(max_length=32,widget=wid_02)
r_pwd=forms.CharField(max_length=32,widget=wid_02)
email=forms.EmailField(widget=wid_01)
tel=forms.CharField(max_length=32,widget=wid_01)
def register(request):
if request.method=="POST":
form=UserForm(request.POST)
if form.is_valid():
print(form.cleaned_data) # 所有干净的字段以及对应的值
else:
print(form.cleaned_data) #
print(form.errors) # ErrorDict : {"校验错误的字段":["错误信息",]}
print(form.errors.get("name")) # ErrorList ["错误信息",]
return HttpResponse("OK")
form=UserForm()
return render(request,"register.html",locals())
渲染标签功能
渲染方式1
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
<link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
</head>
<body>
<h3>注册页面</h3>
<div class="container">
<div class="row">
<div class="col-md-6 col-lg-offset-3">
<form action="" method="post">
{% csrf_token %}
<div>
<label for="">用户名</label>
{{ form.name }}
</div>
<div>
<label for="">密码</label>
{{ form.pwd }}
</div>
<div>
<label for="">确认密码</label>
{{ form.r_pwd }}
</div>
<div>
<label for=""> 邮箱</label>
{{ form.email }}
</div>
<input type="submit" class="btn btn-default pull-right">
</form>
</div>
</div>
</div>
</body>
</html>
渲染方式2
<form action="" method="post">
{% csrf_token %}
{% for field in form %}
<div>
<label for="">{{ field.label }}</label>
{{ field }}
</div>
{% endfor %}
<input type="submit" class="btn btn-default pull-right">
</form>
渲染方式3
<form action="" method="post">
{% csrf_token %}
{{ form.as_p }}
<input type="submit" class="btn btn-default pull-right">
</form>
显示错误与重置输入信息功能
视图
def register(request):
if request.method=="POST":
form=UserForm(request.POST)
if form.is_valid():
print(form.cleaned_data) # 所有干净的字段以及对应的值
else:
print(form.cleaned_data) #
print(form.errors) # ErrorDict : {"校验错误的字段":["错误信息",]}
print(form.errors.get("name")) # ErrorList ["错误信息",]
return render(request,"register.html",locals())
form=UserForm()
return render(request,"register.html",locals())
模板
<form action="" method="post" novalidate>
{% csrf_token %}
{% for field in form %}
<div>
<label for="">{{ field.label }}</label>
{{ field }} <span class="pull-right" style="color: red">{{ field.errors.0 }}</span>
</div>
{% endfor %}
<input type="submit" class="btn btn-default">
</form>
局部钩子与全局钩子
模板
# forms组件
from django.forms import widgets
wid_01=widgets.TextInput(attrs={"class":"form-control"})
wid_02=widgets.PasswordInput(attrs={"class":"form-control"})
from django.core.exceptions import ValidationError
class UserForm(forms.Form):
name=forms.CharField(max_length=32,
widget=wid_01
)
pwd=forms.CharField(max_length=32,widget=wid_02)
r_pwd=forms.CharField(max_length=32,widget=wid_02)
email=forms.EmailField(widget=wid_01)
tel=forms.CharField(max_length=32,widget=wid_01)
# 局部钩子
def clean_name(self):
val=self.cleaned_data.get("name")
if not val.isdigit():
return val
else:
raise ValidationError("用户名不能是纯数字!")
# 全局钩子
def clean(self):
pwd=self.cleaned_data.get("pwd")
r_pwd=self.cleaned_data.get("r_pwd")
if pwd==r_pwd:
return self.cleaned_data
else:
raise ValidationError('两次密码不一致!')
def register(request):
if request.method=="POST":
form=UserForm(request.POST)
if form.is_valid():
print(form.cleaned_data) # 所有干净的字段以及对应的值
else:
clean_error=form.errors.get("__all__")
return render(request,"register.html",locals())
form=UserForm()
return render(request,"register.html",locals())
视图
<form action="" method="post" novalidate>
{% csrf_token %}
{% for field in form %}
<div>
<label for="">{{ field.label }}</label>
{{ field }}
<span class="pull-right" style="color: red">
{% if field.label == 'R pwd' %}
<span>{{ clean_error.0 }}</span>
{% endif %}
{{ field.errors.0 }}
</span>
</div>
{% endfor %}
<input type="submit" class="btn btn-default">
</form>
