常用的Field
1、CharField:用来接收文本
参数:max_length:指定最大长度;min_length:指定最小长度;required:指定是否是必填项,默认为True;error_messages:验证条件不满足时给出的错误提示信息。
2、EmailField:用来接收邮件,会自动验证邮件是否合法。
错误信息的key:required、invalid:。
3、FloatField:用来接收浮点类型,验证通过后会自动将值转换为浮点类型
参数:max_value:最大的值;min_value:最小的值。
错误信息的key:required、invalid、max_value、min_value。
4、IntegerField:用来接收整型,通过验证后会自动转换为整型。
参数:max_value:最大的值;min_value:最小的值。
错误信息的key:required、invalid、max_value、min_value。
5、URLField:用来接收url格式的字符串。
错误信息的key:required、invalid。
常用验证器
在验证某个字段的时候,可以传递一个validators参数来指定验证器,进一步对数据进行过滤。验证器有很多,但是很多验证器通过Field或者一些参数就可以指定了。比如EmailValidator,我们可以通过EmailField来指定。以下是一些常用的验证器:
MaxValueValidator:验证最大值;MinValueValidator:验证最小值;MinLengthValidator:验证最小长度;MaxLengthValidator:验证最大长度;EmailValidator:验证邮箱格式;URLValidator:验证是否是URL格式;RegexValidator:通过正则表达式进行验证。
例如用EmailValidator进行邮箱验证:
from django.core import validators
from django import forms
class MyForm(forms.Form):
email = forms.CharField(validators=[validators.EmailValidator(message='请输入正确格式的邮箱')])
正则表达式验证器:
from django.core import validators
from django import forms
class MyForm(forms.Form):
telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}",message='请输入正确的手机号码')])
自定义验证:
有时,对于一个字段,需要一些复杂的逻辑验证,那么可以通过对某个字段进行自定义的验证。比如注册的表单验证中,需要验证手机号码是否已经被注册过,那么这时候需要检索数据库后判断才知道。对某个字段进行自定义的验证方式是,定义一个方法,这个方法名字的规则是:clean_fieldname。如果验证失败,那么就抛出一个验证错误,比如要验证用户表中是否存在正在注册的手机号:
from django.core import validators
from django import forms
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方法。比如注册时验证两次输入密码是否一致:
from django.core import validators
from django import forms
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)
# 如果来到clean方法说明之前每个字段都验证成功了
def clean(self):
cleaned_data = super().clean()
pwd1 = cleaned_data.get('pwd1')
pwd2 = cleaned_data.get('pwd2')
if pwd1 != pwd2:
raise forms.ValidationError('两次输入密码不一致!')
else:
return cleaned_data
提取错误信息
如果验证失败了, 那么有一些错误信息是我们需要传给前端的。 这时候我们可以通过以下属性来获取:
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
这样就可以把某个字段所有的错误信息直接放在这个列表中。