django表单字段

时间 2019-12-04

标签 django 表单字段栏目 Python 繁體版

原文原文链接

在经过django.forms.Forms建立表单字段时，其中每一个字段都有一些自定义的验证逻辑和一些其余钩子前端

虽然表单字段的Field类主要使用在Form类中，但也能够直接实例化来使用它们，以更好的了解它们是如何工做的，每一个Field的实例都有一个clean()方法，它接收一个参数，而后返回‘清洁的'数据或者抛出一个django.forms.ValidationError异常python

Field.clean(value)git

In [1]: from django import forms                                                                                                     
#建立一个字段
In [2]: f = forms.CharField()                                                                                                        
In [3]: f.clean('1')                                                                                                                 
Out[3]: '1'
In [4]: f.clean(1)                                                                                                                   
Out[4]: '1'
#CharField字段若是没空则抛出异常
In [5]: f.clean('') 
ValidationError                           Traceback (most recent call last)

clean()方法一般用来对数据进行验证和测试比较方便web

核心字段参数：正则表达式

每一个Field类构造函数均可用这些参数django

一、required服务器

Field.required：默认状况下，Field类都必须判断字段的值不能为空值、None或者空的字符串（“”）那么clean()将会引起ValidationError异常；只有在字段设置参数required=False则该字段的值不是必须的便可用为空或None函数

In [6]: fr = forms.CharField()                                                                                                       
In [7]: fr.clean(None)                                                                                                               
---------------------------------------------------------------------------
ValidationError                           Traceback (most recent call last)

In [8]: fq = forms.CharField(required=False)                                                                                         
In [9]: fq.clean(None)                                                                                                               
Out[9]: ''
In [10]: fq.clean("")                                                                                                                
Out[10]: ''

二、label测试

label参数用来给字段添加’人性化'的提示信息，如不指定则Field将因此下划线转换为空格并将第一个字母大写来生成标签ui

from django import forms
class CommentForm(forms.Form):
    name = forms.CharField(label='your name')
    url = forms.URLField(label='your website')
    commnet = forms.CharField()
    
f = CommentForm(auto_id=False)
#auto_id用来简化输出
print(f)
#comment字段未指定label参数则使用字段名生成
<tr><th>your name:</th><td><input type="text" name="name" required></td></tr>
<tr><th>your website:</th><td><input type="url" name="url" required></td></tr>
<tr><th>Commnet:</th><td><input type="text" name="commnet" required></td></tr>

三、label_suffix

django默认为label参数后面添加了冒号后缀，若是想自定义则可用使用label_suffix参数来指定替代符号

class conform(forms.Form):
    name = forms.CharField(label='姓名')
    rename = forms.CharField(label='姓名',label_suffix='==')
    
f = conform(auto_id=False)
print(f)
<tr><th>姓名:</th><td><input type="text" name="name" required></td></tr>
<tr><th>姓名==</th><td><input type="text" name="rename" required></td></tr>

四、initial

该initial参数容许Field在未绑定中呈现此内容时要使用的初始值

from django import forms
class commentform(forms.Form):
    name = forms.CharField(initial='your name')
    url = forms.URLField(initial='http://')
    comment = forms.CharField()
    
f = commentform(auto_id=False)
print(f)
<tr><th>Name:</th><td><input type="text" name="name" value="your name" required></td></tr>
<tr><th>Url:</th><td><input type="url" name="url" value="http://" required></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" required></td></tr>

若是在初始表单时传递数据将触发验证，HTML输出将包括任何验证错误信息，因此initial仅为未绑定表单数据时显示值

from django import forms
class commentform(forms.Form):
    name = forms.CharField(initial='your name')
    url = forms.URLField()
    
data = {'name':"",'url':'http://www.baidu.com'}
f = commentform(data,auto_id=False)
print(f)
<tr><th>Name:</th><td><ul class="errorlist"><li>This field is required.</li></ul><input type="text" name="name" required></td></tr>
<tr><th>Url:</th><td><input type="url" name="url" value="http://www.baidu.com" required></td></tr>

咱们也能够传递任何可调用的变量做为参数传递给initial，如如下实例咱们能够传递一个如今的时间给参数做为初始值

from django import forms
import datetime
class dateform(forms.Form):
    day = forms.DateField(initial=datetime.date.today)
    
print(dateform(auto_id=False))
<tr><th>Day:</th><td><input type="text" name="day" value="2019-04-10" required></td></tr>

五、widget

最重要的参数之一，指定渲染Widget时使用的widget类，也就是在form字段在HTML页面中是显示为文本输入框、密码框、单选按钮或多选框等，此参数内容比较多，之后单篇文章详细介绍

六、help_text

该参数用于设置字段的描述文本，它与模型字段中的hep_text同样，它不会再自动生成的表单中进行HTML转义

from django import forms

class HelptextForm(forms.Form):
    name = forms.CharField(help_text='100 characters max.')
    sender = forms.EmailField(help_text='a email address.')
    
f = HelptextForm(auto_id=False)
print(f)
<tr><th>Name:</th><td><input type="text" name="name" required><br><span class="helptext">100 characters max.</span></td></tr>
<tr><th>Sender:</th><td><input type="email" name="sender" required><br><span class="helptext">a email address.</span></td></tr>

七、error_messages

该参数用于设置覆盖字段将引起的默认异常消息，需传入一个字典，其中的键与要覆盖的错误信息相匹配

#如下是默认的异常信息
generic = forms.EmailField()
generic.clean('')
django.core.exceptions.ValidationError: ['This field is required.']
#下面经过error_messages自定义默认的异常信息
name = forms.EmailField(error_messages={'required':'please enter your email'})
name.clean('')
django.core.exceptions.ValidationError: ['please enter your email']

八、validators

指定一个列表，其中包含为字段进行验证的函数，如，咱们自定义了验证方法，不需熬Django内置的验证功能,那么久须要经过这个参数，将字段与自定义验证的方法经过此参数来指定

九、localize

此参数帮助咱们实现表单数据输入的本地化

十、disabled

设置由该属性的字段在前端页面中将显示为不可编辑的状态

该参数接收布尔值，当设置为True时，使用HTML的disabled属性金庸表单域，使用户没法编辑该字段，即便非法篡改了前端页面的属性，相服务器提交该字段的值也将依然被忽略

十一、has_changed()

该方法用于肯定字段值是否已从初始值更改，返回True或False

内置Field类：对于每一个字段类，下面介绍其默认的Widget，当输入为空值时返回的值，以及蚕蛹何种验证方法，‘规范化为'表示转换为python的何种对象，可用的错误信息键，表示字段可自定义错误信息的类型(字典的键)

十二、BooleanField

默认的Widget：CheckboxInput
空值：False
规范化为：Python的True或者False
可用的错误信息键：required

1三、CharField

默认的Widget：TextInput
空值：empty_value给出的任何值
规范化为：Python的string

验证max_length或min_length，若是设置了这两个参数，不然全部的输入都是合法的
可用的错误信息键：required，min_length，max_length

它有四个可选参数：max_length，min_length用来设置字符串的最大和最小长度；strip默认为True,去除输入的前导和尾随空格；empty_value用来表示'空'的值，默认为空字符串

1四、ChoiceField

默认的Widget：Select

空值：一个空字符串

规范化为：python的string

验证给定的值是否在选项列表中

可用的错误信息键：required，invalid_choice

参数：choices用来做为该字段选项的一个二元组组成的可迭代对象

1五、TypedChoiceField

同ChoiceField同样，只是多了两个额外参数corece和empty_value

默认的Widget：Select

空值：empty_value参数设置的值

规范化为:coerce参数类型的值

验证给定的值在选项列表中存在而且能够被强制转换

可用的错误信息的键：required,invalid_choice

1六、DateField

默认的Widget：DateInput

空值：None

规范化为：datetime.date对象

验证给出的值时一个datetime.date，datetime.datetiem或指定日期格式的字符串

错误信息的键：required，invalid

接收一个可选的参数：input_formats，一个格式的列表，用于转换字符串为datetime.date对象，若是没有提供input_formats默认端输入格式为：

['%Y-%m-%d',    #'2019-4-10'
'%m/%d/%Y',     #'4/10/2019'
'%m/%d/%y']     #'4/10/19'

此外，若是在设置中指定了USE_L10N=False，如下内容也将包含在默认格式中：

['%b %d %Y',      # 'Oct 25 2006'
 '%b %d, %Y',     # 'Oct 25, 2006'
 '%d %b %Y',      # '25 Oct 2006'
 '%d %b, %Y',     # '25 Oct, 2006'
 '%B %d %Y',      # 'October 25 2006'
 '%B %d, %Y',     # 'October 25, 2006'
 '%d %B %Y',      # '25 October 2006'
 '%d %B, %Y']     # '25 October, 2006'

1七、DateTimeField

默认的Widget：DateTimeInput

空值：None

规范化为：python的datetime.datetime对象

验证给出的值时一个datetime.datetime、datetime.date或指定日期格式的字符串

错误信息的键：required，invalid

接收一个可选参数：input_formats，若是没有提供input_formats默认的输入格式为：

['%Y-%m-%d %H:%M:%S',    # '2006-10-25 14:30:59'
 '%Y-%m-%d %H:%M',       # '2006-10-25 14:30'
 '%Y-%m-%d',             # '2006-10-25'
 '%m/%d/%Y %H:%M:%S',    # '10/25/2006 14:30:59'
 '%m/%d/%Y %H:%M',       # '10/25/2006 14:30'
 '%m/%d/%Y',             # '10/25/2006'
 '%m/%d/%y %H:%M:%S',    # '10/25/06 14:30:59'
 '%m/%d/%y %H:%M',       # '10/25/06 14:30'
 '%m/%d/%y']             # '10/25/06'

1八、DecimalField

默认的Widget：当Field.localize是False时为NumberInput，不然为TextInput

空值：None

规范化为：python decimal对象

验证给定的值为一个十进制数，忽略前导和尾随的空白

错误信息的键：max_whole_digits,max_digits,max_decimal_places,max_value,invalid,required,min_value

接收四个可选参数：

max_value，min_value：容许的值范围，须要赋值decimal.Decimal对象，不能直接给个整数类型

max_digits：值容许的最大位数（小数点以前和以后的数字总共的位数，前导的零将被删除）

decimal_places：容许的最大小数位

1九、DurationField

默认的Widget：TextInput

空值：None

规范化为：python timedela

验证给出的值是一个字符串，并且能够转换为timedelta对象

错误信息的键：required，invalid

20、EmailField

默认的Widget：EmailInput
空值：''（一个空字符串）
规范化为：Unicode 对象。
使用正则表达式验证给出的值是一个合法的邮件地址。
错误信息的键：required, invalid
两个可选的参数用于验证，max_length 和min_length

2一、FileField

默认的Widget：ClearableFileInput
空值：None
规范化为：一个UploadedFile对象，它封装文件内容和文件名到一个对象内。
验证非空的文件数据已经绑定到表单。
错误信息的键：missing, invalid, required, empty, max_length
具备两个可选的参数用于验证：max_length 和 allow_empty_file。

2二、FilePathField

默认的Widget：Select
空值：None
规范化为：Unicode 对象。
验证选择的选项在选项列表中存在。
错误信息的键：required, invalid_choice
这个字段容许从一个特定的目录选择文件。它有五个额外的参数，其中的path是必须的：

path：要列出的目录的绝对路径。这个目录必须存在。

recursive：若是为False（默认值），只用直接位于path下的文件或目录做为选项。若是为True，将递归访问这个目录，其内全部的子目录和文件都将做为选项。

match：正则表达模式；只有具备与此表达式匹配的文件名称才被容许做为选项。

allow_files：可选。默认为True。表示是否应该包含指定位置的文件。它和allow_folders必须有一个为True。

allow_folders可选。默认为False。表示是否应该包含指定位置的目录。

2三、FloatField

默认的Widget：当Field.localize是False时为NumberInput，不然为TextInput。
空值：None
规范化为：Float 对象。
验证给定的值是一个浮点数。
错误信息的键：max_value, invalid, required, min_value
接收两个可选的参数用于验证，max_value和min_value，控制容许的值的范围。

2四、ImageField

默认的Widget：ClearableFileInput
空值：None
规范化为：一个UploadedFile 象，它封装文件内容和文件名为一个单独的对象。
验证文件数据已绑定到表单，而且该文件是Pillow能够解析的图像格式。
错误信息的键：missing, invalid, required, empty, invalid_image
使用ImageField须要安装Pillow（pip install pillow）。若是在上传图片时遇到图像损坏错误，一般意味着使用了Pillow不支持的格式。

2五、IntegerField

默认的Widget：当Field.localize是False时为NumberInput，不然为TextInput。
空值：None
规范化为：Python 整数或长整数。
验证给定值是一个整数。容许前导和尾随空格，相似Python的int()函数。
错误信息的键：max_value, invalid, required, min_value
两个可选参数：max_value和min_value，控制容许的值的范围。

2六、GenericIPAddressField

包含IPv4或IPv6地址的字段。

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：一个Unicode对象。
验证给定值是有效的IP地址。
错误信息的键：required, invalid
有两个可选参数：protocol和unpack_ipv4

2七、MultipleChoiceField

默认的Widget：SelectMultiple
空值：[]（一个空列表）
规范化为：一个Unicode 对象列表。
验证给定值列表中的每一个值都存在于选择列表中。
错误信息的键：invalid_list, invalid_choice, required

2八、TypedMultipleChoiceField

相似MultipleChoiceField，除了须要两个额外的参数，coerce和empty_value。

默认的Widget：SelectMultiple
空值：empty_value
规范化为：coerce参数提供的类型值列表。
验证给定值存在于选项列表中而且能够强制。
错误信息的键：required, invalid_choice

2九、NullBooleanField

默认的Widget：NullBooleanSelect
空值：None
规范化为：Python None, False 或True 值。
不验证任何内容（即，它从不引起ValidationError）。

30、RegexField

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：一个Unicode 对象。
验证给定值与某个正则表达式匹配。
错误信息的键：required, invalid
须要一个必需的参数：regex，须要匹配的正则表达式。

还能够接收max_length，min_length和strip参数，相似CharField。

3一、SlugField

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：一个Unicode 对象。
验证给定的字符串只包括字母、数字、下划线及连字符。
错误信息的键：required, invalid
此字段用于在表单中表示模型的SlugField。

3二、TimeField

默认的Widget：TextInput
空值：None
规范化为：一个Python 的datetime.time 对象。
验证给定值是datetime.time或以特定时间格式格式化的字符串。
错误信息的键：required, invalid
接收一个可选的参数：input_formats，用于尝试将字符串转换为有效的datetime.time对象的格式列表。

若是没有提供input_formats，默认的输入格式为：

'%H:%M:%S',     # '14:30:59'
'%H:%M',        # '14:30'

3三、URLField

默认的Widget：URLInput
空值：''（一个空字符串）
规范化为：一个Unicode 对象。
验证给定值是个有效的URL。
错误信息的键：required, invalid
可选参数：max_length和min_length

3四、UUIDField

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：UUID对象。
错误信息的键：required, invalid

3五、ComboField

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：Unicode 对象。
根据指定为ComboField的参数的每一个字段验证给定值。
错误信息的键：required, invalid
接收一个额外的必选参数：fields，用于验证字段值的字段列表（按提供它们的顺序）。

>>> from django.forms import ComboField
>>> f = ComboField(fields=[CharField(max_length=20), EmailField()])
>>> f.clean('test@example.com')
'test@example.com'
>>> f.clean('longemailaddress@example.com')
Traceback (most recent call last):
...
ValidationError: ['Ensure this value has at most 20 characters (it has 28).']

3六、MultiValueField

默认的Widget：TextInput
空值：''（一个空字符串）
规范化为：子类的compress方法返回的类型。
根据指定为MultiValueField的参数的每一个字段验证给定值。
错误信息的键：incomplete, invalid, required

3七、SplitDateTimeField

默认的Widget：SplitDateTimeWidget
空值：None
规范化为：Python datetime.datetime 对象。
验证给定的值是datetime.datetime或以特定日期时间格式格式化的字符串。
错误信息的键：invalid_date, invalid, required, invalid_time

3八、ModelChoiceField

默认小部件： Select
空值： None
规范化为：模型实例。
验证查询集中是否存在给定的id。
错误消息键：required，invalid_choice
queryset必须参数指定一个QuerySet模型对象，并从中处处字段的选项
两个可选参数：
empty_label:可用更改标签文本或设置为None来禁用空标签
to_field_name:用于指定要用做字段窗口中选项的值的字段，以确保它是模型的惟一字段默认为None将使用每一个对象的主键

3九、ModelMultipleChoiceField

默认小部件：SelectMultiple
空值：空QuerySet（self.queryset.none（））
规范化为：QuerySet模型实例
验证查询集中是否存在给定值列表中的每一个id。
错误信息键：required，list，invalid_choice， invalid_pk_value
queryset:必须参数，与ModelChoiceField.queryset相同
一个可选参数：
to_field_name:与ModelChoiceField.to_field_name相同

40、建立自定义字段

若是内置Field类不能知足您的需求，咱们能够轻松建立自定义Field类，为此只需建立一个dango.forms.Field子类，它的惟一要求是，必须实现一个clean()方法，并且其__init__()实现required，label，initial，widget，help_text方法