Python Web框架之Django框架Form组件用法详解

2023-08-17 14:00:05 281

本文实例讲述了PythonWeb框架之Django框架Form组件用法。分享给大家供大家参考，具体如下：

Form简介

在HTTP中，表单（form标签），是用来提交数据的，其action属性说明了其传输数据的方法：如何传、如何接收。

访问网站时，表单可以实现客户端与服务器之间的通信。例如查询，就用到了表单（其属性中，action=get）。

再比如说注册与登陆，也是要用到表单的。但这里由于涉及到隐私问题，需要保证数据传输的安全性，因此其传输方法就应当使用post而非get。

总之，对客户端来说，表单就是用来向服务器提交数据的；

而对服务器来说，表单就是你提供给客户端的发送信息的渠道，你需要对用户发送来的信息进行处理和响应，以达到页面的交互。

DjangoForm的功能

生成HTML标签
验证用户数据（显示错误信息）
HTMLForm提交保留上次提交数据
初始化页面显示内容

DjangoForm验证流程

用于验证用户请求数据合法性的一个组件
如果没有Form就得繁琐地用正则表达式了

a.用户提交数据的验证
1、创建模版classLoginForm(forms.Form):...
2、将请求交给模版，创建一个对象obj=LoginForm(request.POST)
3、进行验证obj.is_valid()
4、获取正确信息obj.clean()
5、获取错误信息obj.errors
b.错误信息提示
Form提交，刷新页面的特性，模版对象内部值丰富，再显示时，值和错误信息都有
c.保留上一次提交的数据
1、自动生成html标签
2、保留上一次提交的数据

Form的创建

fromdjango.shortcutsimportrender,redirect
fromdjangoimportforms
#这里为了简单，把form类写到视图函数
#模版
classLoginForm(forms.Form):
#模版中的元素
user=forms.CharField(min_length=6,error_messages={"required":'用户名不能为空','min_length':'用户名长度不能小6'})
email=forms.EmailField(error_messages={"required":'邮箱不能为空','invalid':'邮箱格式错误'})
deflogin(request):
ifrequest.method=="GET":
#数据库中获取
obj=LoginForm()
returnrender(request,'login.html',{'oo':obj})
elifrequest.method=="POST":
"""
obj=LoginForm(request.POST)
#验证
status=obj.is_valid()
print(status)
value_dict=obj.clean()验证成功的值，输入格式正确的拿到了
print(value_dict)
#error_obj=obj.errors
error_obj=obj.errors.as_json()
print(error_obj)code定义错误信息
"""
obj=LoginForm(request.POST)
ifobj.is_valid():
value_dict=obj.clean()
print(value_dict)
#create(**value_dict)
else:
#封装了所有的错误信息
#error_obj=obj.errors
#print(obj.errors['email'][0],type(error_obj['email'])
#print(obj.errors['email'][0],type(error_obj['email'][0])
#print(obj.errors["user"][0])
#print(type(error_obj))
fromdjango.forms.utilsimportErrorDict
pass
returnrender(request,'login.html',{'oo':obj})

当然你也可以在app里创建form.py文件，在里面创建类：

下文将使用这个文件。

fromdjangoimportformsasDForms
fromdjango.formsimportfields
fromdjango.formsimportwidgets
fromdjango.core.validatorsimportRegexValidator
classDetailForm(DForms.Form):
user1=fields.CharField()#默认input框，可以改成select，radio等
user2=fields.CharField(widget=widgets.TextInput)
user4=fields.IntegerField()
#字符串
user3=fields.ChoiceField(choices=[(1,'SH'),(2,'BJ'),])
user5=fields.CharField(
widget=widgets.Select(choices=[(1,'SH'),(2,'BJ'),])
)
user6=fields.IntegerField(
widget=widgets.Select(choices=[(1,'SH'),(2,'BJ'),])
)
user7=fields.IntegerField(
widget=widgets.RadioSelect(choices=[(1,'SH'),(2,'BJ'),])
)
#{'user1':'11','user2':'22','user4':33,'user3':'1','user5':'2','user6':1,'user7':2}

视图函数：

fromdjango.shortcutsimportrender,redirect
fromapp01importforms
defdetail(request):
obj=forms.DetailForm(request.POST)
obj.is_valid()
print(obj.clean())
returnrender(request,'detail.html',{'obj':obj})

生成HTML：





Title



{{obj.user1}}
{{obj.user2}}
{{obj.user3}}
{{obj.user4}}
{{obj.user5}}
{{obj.user6}}
{{obj.user7}}

常用HTML标签：


{%csrf_token%}
{{form.xxoo.label}}
{{form.xxoo.id_for_label}}
{{form.xxoo.label_tag}}
{{form.xxoo.errors}}
{{form.user}}{{form.user.errors}}

运行后后台返回结果：

#{'user1':'11','user2':'22','user4':33,'user3':'1','user5':'2','user6':1,'user7':2}

下面将讲解为什么是这个结果

Django的Form的实现步骤：

a.创建一个验证用户请求的模板包含：

类：模版，到底验证几个
字段：用于验证用户某个字段
插件：user=forms.CharField(..,widget=Input框)

Django内置字段如下：

1，字段核心参数

每个字段类的构造函数至少接受这些参数。有些字段类接受额外的、字段特有的参数，但以下参数应该总是能接受：

Field.required
默认情况下，每个字段类都假设必需有值，所以如果你传递一个空的值——不管是None还是空字符串(“”)——clean()将引发一个ValidationError异常。

Field.label
正如在前面“输出表单为HTML”中解释的，字段默认label是通过将字段名中所有的下划线转换成空格并大写第一个字母生成的。如果默认的标签不合适，可以指定label。

Field.label_suffix
label_suffix参数让你基于每个字段覆盖表单的label_suffix。

Field.initial
initial参数让你指定渲染未绑定的表单中的字段时使用的初始值。

Field.widget
widget参数让你指定渲染表单时使用的Widget类。更多信息参见Widgets。

Field.help_text
help_text参数让你指定字段的描述文本。如果提供help_text，在通过表单的便捷方法（例如，as_ul()）渲染字段时，它将紧接着字段显示。

Field.error_messages
error_messages参数让你覆盖字段引发的异常中的默认信息。传递的是一个字典，其键为你想覆盖的错误信息。

Field.validators
validators参数让你可以为字段提供一个验证函数的列表。

Field.localize
localize参数启用表单数据的本地化，包括输入和输出。

Field.has_changed()
has_changed()方法用于决定字段的值是否从初始值发生了改变。返回True或False。

2，内建字段

Field
required=True, 是否允许为空
widget=None, HTML插件
label=None, 用于生成Label标签或显示内容
initial=None, 初始值
help_text='', 帮助信息(在标签旁边显示)
error_messages=None, 错误信息{'required':'不能为空','invalid':'格式错误'}
show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直）
validators=[], 自定义验证规则
localize=False, 是否支持本地化
disabled=False, 是否可以编辑
label_suffix=None Label内容后缀

CharField(Field)
max_length=None, 最大长度
min_length=None, 最小长度
strip=True 是否移除用户输入空白

默认的Widget：TextInput
空值：'‘（一个空字符串）
规范化为：一个Unicode对象。
如果提供，验证max_length或min_length。否则，所有的输入都是合法的。
错误信息的键：required,max_length,min_length

可选参数：max_length,min_length

IntegerField(Field)
max_value=None, 最大值
min_value=None, 最小值

FloatField(IntegerField)

默认的Widget：当Field.localize是False时为NumberInput，否则为TextInput。
空值：None
规范化为：一个Float对象。
验证给出的值是一个浮点数。和Python的float()函数一样，允许前导和尾随的空白符。
错误信息的键：required,invalid,max_value,min_value

DecimalField(IntegerField)
max_value=None, 最大值
min_value=None, 最小值
max_digits=None, 总长度
decimal_places=None, 小数位长度

BaseTemporalField(Field)
input_formats=None 时间格式化

DateField(BaseTemporalField) 格式：2015-09-01
TimeField(BaseTemporalField) 格式：11:12
DateTimeField(BaseTemporalField)格式：2015-09-0111:12

DurationField(Field) 时间间隔：%d%H:%M:%S.%f

默认的Widget：TextInput
空值：None
规范化为：一个Pythontimedelta。
验证给出的值是一个字符串，而可以给转换为timedelta。
错误信息的键：required,invalid.

RegexField(CharField)
regex, 自定制正则表达式
max_length=None, 最大长度
min_length=None, 最小长度
error_message=None, 忽略，错误信息使用error_messages={'invalid':'...'}

EmailField(CharField)

默认的Widget：EmailInput
空值：”（一个空字符串）
规范化为：一个Unicode对象。
验证给出的值是一个合法的邮件地址，使用一个适度复杂的正则表达式。
错误信息的键：required,invalid

FileField(Field)
allow_empty_file=False 是否允许空文件

ImageField(FileField)
...
注：需要PIL模块，pip3installPillow
以上两个字典使用时，需要注意两点：
-form表单中enctype="multipart/form-data"
-view函数中obj=MyForm(request.POST,request.FILES)

URLField(Field)

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

BooleanField(Field)

默认的Widget：CheckboxInput
空值：False
规范化为：Python的True或False。
如果字段带有required=True，验证值是否为True（例如复选框被勾上）。
错误信息的键：required

NullBooleanField(BooleanField)

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

ChoiceField(Field)
...
choices=(), 选项，如：choices=((0,'上海'),(1,'北京'),)
required=True, 是否必填
widget=None, 插件，默认select插件
label=None, Label内容
initial=None, 初始值
help_text='', 帮助提示

默认的Widget：Select
空值：”（一个空字符串）
规范化为：一个Unicode对象。
验证给定的值在选项列表中存在。
错误信息的键：required,invalid_choice

ModelChoiceField(ChoiceField)
... django.forms.models.ModelChoiceField
queryset, #查询数据库中的数据
empty_label="---------", #默认空显示内容
to_field_name=None, #HTML中value的值对应的字段
limit_choices_to=None #ModelForm中对queryset二次筛选

ModelMultipleChoiceField(ModelChoiceField)
... django.forms.models.ModelMultipleChoiceField
MultipleChoiceField(**kwargs)

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

TypedMultipleChoiceField(**kwargs)
就像MultipleChoiceField，除了TypedMultipleChoiceField需要两个额外的参数，coerce和empty_value。

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

TypedChoiceField(ChoiceField)
coerce=lambdaval:val 对选中的值进行一次转换
empty_value='' 空值的默认值

默认的Widget：Select
空值：empty_value
规范化为：coerce参数类型的值。
验证给定的值在选项列表中存在并且可以被强制转换。
错误信息的键：required,invalid_choice

ImageField(**kwargs)

默认的Widget：ClearableFileInput
空值：None
规范化为:AnUploadedFileobjectthatwrapsthefilecontentandfilenameintoasingleobject.
验证文件数据已绑定到表单，并且该文件具有Pillow理解的图像格式。
错误信息的键：required,invalid,missing,empty,invalid_image

TypedMultipleChoiceField(MultipleChoiceField)
coerce=lambdaval:val 对选中的每一个值进行一次转换
empty_value='' 空值的默认值

ComboField(Field)
fields=() 使用多个验证，如下：即验证最大长度20，又验证邮箱格式
fields.ComboField(fields=[fields.CharField(max_length=20),fields.EmailField(),])

MultiValueField(Field)
PS:抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用

SplitDateTimeField(MultiValueField)
input_date_formats=None, 格式列表：['%Y--%m--%d','%m%d/%Y','%m/%d/%y']
input_time_formats=None 格式列表：['%H:%M:%S','%H:%M:%S.%f','%H:%M']

FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中
path, 文件夹路径
match=None, 正则匹配
recursive=False, 递归下面的文件夹
allow_files=True, 允许文件
allow_folders=False, 允许文件夹
required=True,
widget=None,
label=None,
initial=None,
help_text=''

path，你想要列出的目录的绝对路径。这个目录必须存在。
recursive，如果为False（默认值），只用直接位于path下的文件或目录作为选项。如果为True，将递归访问这个目录，其所有的子目录和文件都将作为选项。
match，正则表达式表示的一个模式；只有匹配这个表达式的名称才允许作为选项。
allow_files，可选。为True或False。默认为True。表示是否应该包含指定位置的文件。它和allow_folders必须有一个为True。
allow_folders，可选。为True或False。默认为False。表示是否应该包含指定位置的目录。它和allow_files必须有一个为True。

FileField(**kwargs)

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

GenericIPAddressField
protocol='both', both,ipv4,ipv6支持的IP格式
unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1，PS：protocol必须为both才能启用
SlugField(CharField) 数字，字母，下划线，减号（连字符）
...
UUIDField(CharField) uuid类型

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

3.处理关系字段

两个字段可用于表示模型之间的关系：ModelChoiceField和ModelMultipleChoiceField。这两个字段都需要单个queryset参数，用于创建字段的选择。在表单验证时，这些字段将把一个模型对象（在ModelChoiceField的情况下）或多个模型对象（在ModelMultipleChoiceField的情况下）放置到cleaned_data表单的字典。

对于更复杂的用法，可以在声明表单字段时指定queryset=None，然后在窗体的init()方法中填充queryset：

ModelChoiceField(**kwargs)

默认的Widget：Select
空值：None
规范化为：一个模型实例。
验证给定的id存在于查询集中。
错误信息的键：required,invalid_choice

ModelMultipleChoiceField(**kwargs)

默认的Widget：SelectMultiple
空值：QuerySet(self.queryset.none())
规范化为：模型实例的一个QuerySet。
验证在给定的值列表中的每个id存在于查询集中。
错误信息的键：required,list,invalid_choice,invalid_pk_value

Django内置插件：

TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget

#单radio，值为字符串
#user=fields.CharField(
#initial=2,
#widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
#)
#单radio，值为字符串
#user=fields.ChoiceField(
#choices=((1,'上海'),(2,'北京'),),
#initial=2,
#widget=widgets.RadioSelect
#)
#单select，值为字符串
#user=fields.CharField(
#initial=2,
#widget=widgets.Select(choices=((1,'上海'),(2,'北京'),))
#)
#单select，值为字符串
#user=fields.ChoiceField(
#choices=((1,'上海'),(2,'北京'),),
#initial=2,
#widget=widgets.Select
#)
#多选select，值为列表
#user=fields.MultipleChoiceField(
#choices=((1,'上海'),(2,'北京'),),
#initial=[1,],
#widget=widgets.SelectMultiple
#)
#单checkbox
#user=fields.CharField(
#widget=widgets.CheckboxInput()
#)
#多选checkbox,值为列表
#user=fields.MultipleChoiceField(
#initial=[2,],
#choices=((1,'上海'),(2,'北京'),),
#widget=widgets.CheckboxSelectMultiple
#)

在使用选择标签时，需要注意choices的选项可以从数据库中获取，但是由于是静态字段***获取的值无法实时更新***，那么需要自定义构造方法从而达到此目的。

如果内建的字段不能满足你的需求，你可以很容易地创建自定义的字段。你需要创建django.forms.Field的一个子类。它只要求实现一个clean()方法和接收上面核心参数的init()方法(required,label,initial,widget,help_text)。

#方法一：
fromapp01importmodels
classDBForm(DForms.Form):
host=fields.CharField()
host_type=fields.IntegerField(
widget=widgets.Select(choices=[])
)
def__init__(self,*args,**kwargs):
#执行父类的构造方法
super(DBForm,self).__init__(*args,**kwargs)
self.fields['host_type'].widget.choices=models.UserType.objects.all().values_list('id','caption')
#方法二：使用django提供的ModelChoiceField和ModelMultipleChoiceField字段来实现
fromdjangoimportforms
fromdjango.formsimportfields
fromdjango.formsimportwidgets
fromdjango.formsimportmodelsasform_model
fromdjango.core.exceptionsimportValidationError
fromdjango.core.validatorsimportRegexValidator
classFInfo(forms.Form):
authors=form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())
#authors=form_model.ModelChoiceField(queryset=models.NNewType.objects.all())

自定义Form验证规则：

fromdjango.formsimportForm
fromdjango.formsimportwidgets
fromdjango.formsimportfields
fromdjango.core.validatorsimportRegexValidator
#方法一
classMyForm(Form):
user=fields.CharField(
validators=[RegexValidator(r'^[0-9]+$','请输入数字'),RegexValidator(r'^159[0-9]+$','数字必须以159开头')],
)
#方法二
defmobile_validate(value):
mobile_re=re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$')
ifnotmobile_re.match(value):
raiseValidationError('手机号码格式错误')
phone=fields.CharField(validators=[mobile_validate,],
error_messages={'required':'手机不能为空'},
widget=widgets.TextInput(attrs={'class':"form-control",
'placeholder':u'手机号码'}))
#方法三
fromdjangoimportforms
fromdjango.formsimportfields
fromdjango.formsimportwidgets
fromdjango.core.exceptionsimportValidationError
fromdjango.core.validatorsimportRegexValidator
classFInfo(forms.Form):
username=fields.CharField(max_length=5,
validators=[RegexValidator(r'^[0-9]+$','Enteravalidextension.','invalid')],)
email=fields.EmailField()
defclean_username(self):
"""
Form中字段中定义的格式匹配完之后，执行此方法进行验证
:return:
"""
value=self.cleaned_data['username']
if"666"invalue:
raiseValidationError('666已经被玩烂了...','invalid')
returnvalue

同时生成多个标签验证：

fromdjango.formsimportForm
fromdjango.formsimportwidgets
fromdjango.formsimportfields
fromdjango.core.validatorsimportRegexValidator
##############自定义字段##############
classPhoneField(fields.MultiValueField):
def__init__(self,*args,**kwargs):
#Defineonemessageforallfields.
error_messages={
'incomplete':'Enteracountrycallingcodeandaphonenumber.',
}
#Ordefineadifferentmessageforeachfield.
f=(
fields.CharField(
error_messages={'incomplete':'Enteracountrycallingcode.'},
validators=[
RegexValidator(r'^[0-9]+$','Enteravalidcountrycallingcode.'),
],
),
fields.CharField(
error_messages={'incomplete':'Enteraphonenumber.'},
validators=[RegexValidator(r'^[0-9]+$','Enteravalidphonenumber.')],
),
fields.CharField(
validators=[RegexValidator(r'^[0-9]+$','Enteravalidextension.')],
required=False,
),
)
super(PhoneField,self).__init__(error_messages=error_messages,fields=f,require_all_fields=False,*args,
**kwargs)
defcompress(self,data_list):
"""
当用户验证都通过后，该值返回给用户
:paramdata_list:
:return:
"""
returndata_list

希望本文所述对大家基于Django框架的Python程序设计有所帮助。

Python Web框架之Django框架Form组件用法详解

热门推荐

随机推荐