目录
使用Form对象定义表单
Form对象的特性
表单字段的基类Field
常用的表单字段类型
基于Model定制的表单
ModelForm定义方式
表单中的常用方法
在Web站点中与后端服务进行交互，通常使用表单提交的方式。表单提交数据到达后端，首先要对数据做校验，对于不合法的数据需要拒绝并提示给前端，通过校验之后才能执行服务返回响应。由于所有的表单创建与处理流程都是相似的，所以，Django将这一过程抽象出来，形成表单系统。从在浏览器中显示表单到数据验证，再到对错误的处理，都可以由表单系统来完成。不仅如此，基于数据表（Model）创建表单也是很常见的情况，Django同样考虑到了这一点，并提供了ModelForm来简化功能实现。
使用Form对象定义表单
表单系统的核心是Form对象，它将表单中的字段封装成一系列Field和验证规则，以此来自动地生成HTML表单标签。
与其他对象的定义规则类似，可以将Form对象定义在任何位置。但是，Django的建议是将它们定义在应用下的forms.py文件中。这样做的原因是归类存储，
from django import forms
class titleform(forms.Form):
title = forms.CharField(label='Topic title')
上面代码中，可以发现Form的定义与Model的定义非常相似，比较容易理解。这里的TopicSearchForm定义内容非常少。
- Django规定，所有的Form对象都必须继承自django.forms.Form，所以这里的TopicSearchForm符合条件。
- 定义了一个title属性，它是forms.CharField类型的Field，根据名称可以猜测此处将title指定为字符类型。label标签显式地指定了这个字段的名称，且Field有一个默认属性required为True，代表这个字段是必填的。
Form对象的特性
- 实现对所有字段的验证
- 每一个Form对象实例都会有一个is_valid方法，这个方法根据字段的定义验证实例的各个字段是否合法。如果所有的字段都是合法的，它会返回True，并且将数据存储到字典类型的cleaned_data属性中。
- 根据字段定义生成HTML
- 表单实例可以自动生成HTML表单元素，且默认输出使用HTML表格，但是并不提供
起始和结束标签。同时，也可以使用实例的as_ul方法获取列表形式的表单或使用as_p方法获取段落形式的表单。- 由于表单实例可以直接返回HTML表单元素，所以，可以用它来替换模板文件中的字段定义。更方便的是，在没有正确填充表单时，它还可以返回错误信息的提示。
表单字段的基类Field
基类Field定义于django/forms/fields.py文件中，这里重点关注它的构造函数中定义的属性以及校验给定字段值是否有效的clean方法。
- required
- 设定当前的Field是否是必须提供的，默认值是True，即必须提供。
- widget
- 指定在页面中显示字段的控件，可以是Widget类或者Widget类实例。对于大多数情况，默认的控件使用TextInput。
- label
- 指定在页面中显示的字段的名称（标签）提示。如果不指定的话，则页面中将直接显示字段定义的变量名（首字母大写）。
- initial
- 指定字段的初始值，默认为None。当给字段的initial属性设定一个非空值时，页面中的对应表单将使用这个值填充。
- help_text
- 用于给当前的字段添加描述性信息，提示当前字段的作用或需要输入的内容解释。如果设定了该属性，则其在页面中将会显示在旁边。
- error_messages
- 用于覆盖Field默认的错误消息。
- disabled
- 其默认值是False，如果修改为True，则当前的表单字段将不可编辑。当设置字段为不可编辑时，需要提供初始值（initial），否则，这个字段也就没有意义了。
常用的表单字段类型
Django表单系统内置了数十种表单字段类型，几乎可以满足所有的表单使用场景。如果这些内置的字段类型都不能满足所需的业务场景，Django也支持自定义Field类。
- CharField
- 其为字符串类型的表单字段，是最常见的表单字段类型，widget默认使用TextInput
- max_length限制字段值的最大长度
- min_length限制字段值的最小长度
- strip属性默认会执行Python字符串的strip方法，用于去除字符串开头和尾部的空格。如果不需要这样做，可以将strip属性设置为False：
- empty_value：用来表示"空"的值。默认为空字符串。
- IntegerField
- 其为整数类型的表单字段，widget默认使用NumberInput。
- 可选的max_value与min_value参数用于限定字段值的取值范围，且它们都是闭区间。如果提供了这两个参数（或其中之一），且给定的字段值不在取值范围内，将会抛出异常，并带有错误提示信息。
- BooleanField
- 其为布尔类型的表单字段，widget默认使用CheckboxInput。
- 由于基类Field的required属性默认是True，所以，在不做设置的情况下，BooleanField实例的required属性也是True。由于required为True要求这个字段值必须提供，所以，这种情况下，BooleanField类型的实例必须是True，否则将抛出异常，并提示：“This fieldis required.”。
- 如果要在表单中使用BooleanField字段，则需要指定required为False：
- ChoiceField
- 其为选择类型的表单字段，widget默认使用Select。
- choices参数需要一个可迭代的二元组或能够返回可迭代二元组的函数对象。与模型中的choices参数使用方法一样。
- EmailField
- 它继承自CharField，但是提供了Email验证器，用于校验传递的字段值是否是合法的电子邮件地址。widget默认使用EmailInput。
- 除了EmailField之外，表单系统还提供了UUIDField、GenericIPAddressField、URLField等基于CharField的字段类型用于校验特定结构的字符串。
- UUIDField
- 与EmailField类似，不过它只会验证数据是否会空，并会自动将数据生成唯一列，并设置为主键
- GenericIPAddressField
- 与EmailField类似，不过是验证给定的值是一个有效的 IP 地址。
- URLField
- 与EmailField类似，不过是验证给定值是一个有效的 URL的。
- DateTimeField
- 用于表示时间的表单字段，widget默认使用DateTimeInput。
- 接受一个可选的参数input_formats，这个参数是一个列表，列表元素规定了可以转换为datetime.datetime的时间格式。
- DateTimeField的clean方法接受的值类型可以是datetime.datetime、datetime.date或符合特定格式的字符串，最终会返回datetime.datetime对象或抛出异常。
基于Model定制的表单
将Model翻译成表单是很常见的业务场景，利用Form对象并不难实现，只需要将Model中定义的字段翻译成Form对象中的表单字段即可。但是，如果这种需求很多，且Model中定义的字段也较多，那么重复实现这种表单的过程会很烦琐的。Django表单系统考虑到了这个问题，提供了ModelForm，可以基于Model的定义自动生成表单，很大程度上简化了Model翻译成表单的过程。译成表单字段类型，但是，并不会翻译所有的字段，editable=False的模型字段都不会出现在ModelForm中，如自增主键、自动添加的时间字段等。
ModelForm定义方式
class PrettyModelForm(forms.ModelForm):
class Meta:
model = models.PrettyNum
fields = ["name", ]
# fields = "__all__"
# exclude = ['level']
上面代码中就是自动生成了models.PrettyNum模型中的name字段的表单。
常用的Meta选项
- fields
- 其为列表或元组类型,
- 它指定当前的表单应该包含哪些字段，如果要所有的Model字段都包含在表单中，可以设定fields='__all__'。
- ModelForm的定义中必须要包含fields或exclude选项，否则将会抛出异常，同时给出错误提示：Creating a ModelForm without eitherthe'fields'attribute or the'exclude'attribute isprohibited。
- exclude
- 与fields类似，不过是指向当前的表单不应该包含哪些字段，是与fields相反
- labels
- 其为字典类型，用于定义表单字段的名称（输入框左边显示的名称）。表单字段的名称首先会使用Model字段定义设置的verbose_name，如果没有设置，则直接使用字段名。因此当没有定义verbose_name时，就可以使用labels选项来指定字段名。
- help_texts
- 其为字典类型，用于给表单字段添加帮助信息。目前页面中表单字段的帮助信息（输入框下方显示的内容）来自Model字段的help_texts定义，如果没有定义则什么都不显示。help_texts的定义方式与labels选项类似，
- widgets
- 其为字典类型，用于定义表单字段选用的控件。默认情况下，ModelForm会根据Model字段的类型映射表单Field类，因此会应用Field类中默认定义的widgets。这个选项用于自定义控件类型
- field_classes
- 其为字典类型，用于指定表单字段使用的Field类型。默认情况下，对于title字段，ModelForm会将它映射为fields.CharField类型。可以根据需要改变这种默认行为
表单中的常用方法
- is_valid()
- 校验字段值的合法性
- cleaned_data属性
- 获取清理后的字段值
- save()
- 字段值通过校验（is_valid）之后，可以使用ModelForm提供的save方法实现Model对象的保存。
注意：使用ModelForm类时，需要先使用该类生成对象。如果需要获取使用ModelForm验证的数据则为：
form = PrettyModelForm(data=request.POST)
PrettyModelForm是类名
Python相关栏目本月热门文章
- 1【Linux驱动开发】设备树详解（二）设备树语法详解
- 2别跟客户扯细节
- 3Springboot+RabbitMQ+ACK机制(生产方确认(全局、局部)、消费方确认)、知识盲区
- 4【Java】对象处理流（ObjectOutputStream和ObjectInputStream）
- 5【分页】常见两种SpringBoot项目中分页技巧
- 6一文带你搞懂OAuth2.0
- 7我要写整个中文互联网界最牛逼的JVM系列教程 | 「JVM与Java体系架构」章节：虚拟机与Java虚拟机介绍
- 8【Spring Cloud】新闻头条微服务项目：FreeMarker模板引擎实现文章静态页面生成
- 9JavaSE - 封装、static成员和内部类
- 10树莓派mjpg-streamer实现监控及拍照功能调试
- 11用c++写一个蓝屏代码
- 12从JDK8源码中看ArrayList和LinkedList的区别
- 13idea 1、报错java: 找不到符号 符号: 变量 log 2、转换成Maven项目
- 14在openwrt使用C语言增加ubus接口（包含C uci操作）
- 15Spring 解决循环依赖
- 16SpringMVC——基于MVC架构的Spring框架
- 17Andy‘s First Dictionary C++ STL set应用
- 18动态内存管理
- 19我的创作纪念日
- 20Docker自定义镜像-Dockerfile
热门相关搜索
路由器设置
木托盘
宝塔面板
儿童python教程
心情低落
朋友圈
vim
双一流学科
专升本
我的学校
日记学校
西点培训学校
汽修学校
情书
化妆学校
塔沟武校
异形模板
西南大学排名
最精辟人生短句
6步教你追回被骗的钱
南昌大学排名
清朝十二帝
北京印刷学院排名
北方工业大学排名
北京航空航天大学排名
首都经济贸易大学排名
中国传媒大学排名
首都师范大学排名
中国地质大学(北京)排名
北京信息科技大学排名
中央民族大学排名
北京舞蹈学院排名
北京电影学院排名
中国戏曲学院排名
河北政法职业学院排名
河北经贸大学排名
天津中德应用技术大学排名
天津医学高等专科学校排名
天津美术学院排名
天津音乐学院排名
天津工业大学排名
北京工业大学耿丹学院排名
北京警察学院排名
天津科技大学排名
北京邮电大学(宏福校区)排名
北京网络职业学院排名
北京大学医学部排名
河北科技大学排名
河北地质大学排名
河北体育学院排名
名师互学网 版权所有 (c)2021-2022 ICP备案号：晋ICP备2021003244-6号
- 每一个Form对象实例都会有一个is_valid方法，这个方法根据字段的定义验证实例的各个字段是否合法。如果所有的字段都是合法的，它会返回True，并且将数据存储到字典类型的cleaned_data属性中。
- 表单实例可以自动生成HTML表单元素，且默认输出使用HTML表格，但是并不提供
起始和结束标签。同时，也可以使用实例的as_ul方法获取列表形式的表单或使用as_p方法获取段落形式的表单。
- 由于表单实例可以直接返回HTML表单元素，所以，可以用它来替换模板文件中的字段定义。更方便的是，在没有正确填充表单时，它还可以返回错误信息的提示。
表单字段的基类Field
基类Field定义于django/forms/fields.py文件中，这里重点关注它的构造函数中定义的属性以及校验给定字段值是否有效的clean方法。
- required
- 设定当前的Field是否是必须提供的，默认值是True，即必须提供。
- widget
- 指定在页面中显示字段的控件，可以是Widget类或者Widget类实例。对于大多数情况，默认的控件使用TextInput。
- label
- 指定在页面中显示的字段的名称（标签）提示。如果不指定的话，则页面中将直接显示字段定义的变量名（首字母大写）。
- initial
- 指定字段的初始值，默认为None。当给字段的initial属性设定一个非空值时，页面中的对应表单将使用这个值填充。
- help_text
- 用于给当前的字段添加描述性信息，提示当前字段的作用或需要输入的内容解释。如果设定了该属性，则其在页面中将会显示在旁边。
- error_messages
- 用于覆盖Field默认的错误消息。
- disabled
- 其默认值是False，如果修改为True，则当前的表单字段将不可编辑。当设置字段为不可编辑时，需要提供初始值（initial），否则，这个字段也就没有意义了。
常用的表单字段类型
Django表单系统内置了数十种表单字段类型，几乎可以满足所有的表单使用场景。如果这些内置的字段类型都不能满足所需的业务场景，Django也支持自定义Field类。
- CharField
- 其为字符串类型的表单字段，是最常见的表单字段类型，widget默认使用TextInput
- max_length限制字段值的最大长度
- min_length限制字段值的最小长度
- strip属性默认会执行Python字符串的strip方法，用于去除字符串开头和尾部的空格。如果不需要这样做，可以将strip属性设置为False：
- empty_value：用来表示"空"的值。默认为空字符串。
- IntegerField
- 其为整数类型的表单字段，widget默认使用NumberInput。
- 可选的max_value与min_value参数用于限定字段值的取值范围，且它们都是闭区间。如果提供了这两个参数（或其中之一），且给定的字段值不在取值范围内，将会抛出异常，并带有错误提示信息。
- BooleanField
- 其为布尔类型的表单字段，widget默认使用CheckboxInput。
- 由于基类Field的required属性默认是True，所以，在不做设置的情况下，BooleanField实例的required属性也是True。由于required为True要求这个字段值必须提供，所以，这种情况下，BooleanField类型的实例必须是True，否则将抛出异常，并提示：“This fieldis required.”。
- 如果要在表单中使用BooleanField字段，则需要指定required为False：
- ChoiceField
- 其为选择类型的表单字段，widget默认使用Select。
- choices参数需要一个可迭代的二元组或能够返回可迭代二元组的函数对象。与模型中的choices参数使用方法一样。
- EmailField
- 它继承自CharField，但是提供了Email验证器，用于校验传递的字段值是否是合法的电子邮件地址。widget默认使用EmailInput。
- 除了EmailField之外，表单系统还提供了UUIDField、GenericIPAddressField、URLField等基于CharField的字段类型用于校验特定结构的字符串。
- UUIDField
- 与EmailField类似，不过它只会验证数据是否会空，并会自动将数据生成唯一列，并设置为主键
- GenericIPAddressField
- 与EmailField类似，不过是验证给定的值是一个有效的 IP 地址。
- URLField
- 与EmailField类似，不过是验证给定值是一个有效的 URL的。
- DateTimeField
- 用于表示时间的表单字段，widget默认使用DateTimeInput。
- 接受一个可选的参数input_formats，这个参数是一个列表，列表元素规定了可以转换为datetime.datetime的时间格式。
- DateTimeField的clean方法接受的值类型可以是datetime.datetime、datetime.date或符合特定格式的字符串，最终会返回datetime.datetime对象或抛出异常。
基于Model定制的表单
将Model翻译成表单是很常见的业务场景，利用Form对象并不难实现，只需要将Model中定义的字段翻译成Form对象中的表单字段即可。但是，如果这种需求很多，且Model中定义的字段也较多，那么重复实现这种表单的过程会很烦琐的。Django表单系统考虑到了这个问题，提供了ModelForm，可以基于Model的定义自动生成表单，很大程度上简化了Model翻译成表单的过程。译成表单字段类型，但是，并不会翻译所有的字段，editable=False的模型字段都不会出现在ModelForm中，如自增主键、自动添加的时间字段等。
ModelForm定义方式
class PrettyModelForm(forms.ModelForm): class Meta: model = models.PrettyNum fields = ["name", ] # fields = "__all__" # exclude = ['level']上面代码中就是自动生成了models.PrettyNum模型中的name字段的表单。
常用的Meta选项
- fields
- 其为列表或元组类型,
- 它指定当前的表单应该包含哪些字段，如果要所有的Model字段都包含在表单中，可以设定fields='__all__'。
- ModelForm的定义中必须要包含fields或exclude选项，否则将会抛出异常，同时给出错误提示：Creating a ModelForm without eitherthe'fields'attribute or the'exclude'attribute isprohibited。
- exclude
- 与fields类似，不过是指向当前的表单不应该包含哪些字段，是与fields相反
- labels
- 其为字典类型，用于定义表单字段的名称（输入框左边显示的名称）。表单字段的名称首先会使用Model字段定义设置的verbose_name，如果没有设置，则直接使用字段名。因此当没有定义verbose_name时，就可以使用labels选项来指定字段名。
- help_texts
- 其为字典类型，用于给表单字段添加帮助信息。目前页面中表单字段的帮助信息（输入框下方显示的内容）来自Model字段的help_texts定义，如果没有定义则什么都不显示。help_texts的定义方式与labels选项类似，
- widgets
- 其为字典类型，用于定义表单字段选用的控件。默认情况下，ModelForm会根据Model字段的类型映射表单Field类，因此会应用Field类中默认定义的widgets。这个选项用于自定义控件类型
- field_classes
- 其为字典类型，用于指定表单字段使用的Field类型。默认情况下，对于title字段，ModelForm会将它映射为fields.CharField类型。可以根据需要改变这种默认行为
表单中的常用方法
- is_valid()
- 校验字段值的合法性
- cleaned_data属性
- 获取清理后的字段值
- save()
- 字段值通过校验（is_valid）之后，可以使用ModelForm提供的save方法实现Model对象的保存。
注意：使用ModelForm类时，需要先使用该类生成对象。如果需要获取使用ModelForm验证的数据则为：
form = PrettyModelForm(data=request.POST)
PrettyModelForm是类名
Python相关栏目本月热门文章
- 1【Linux驱动开发】设备树详解（二）设备树语法详解
- 2别跟客户扯细节
- 3Springboot+RabbitMQ+ACK机制(生产方确认(全局、局部)、消费方确认)、知识盲区
- 4【Java】对象处理流（ObjectOutputStream和ObjectInputStream）
- 5【分页】常见两种SpringBoot项目中分页技巧
- 6一文带你搞懂OAuth2.0
- 7我要写整个中文互联网界最牛逼的JVM系列教程 | 「JVM与Java体系架构」章节：虚拟机与Java虚拟机介绍
- 8【Spring Cloud】新闻头条微服务项目：FreeMarker模板引擎实现文章静态页面生成
- 9JavaSE - 封装、static成员和内部类
- 10树莓派mjpg-streamer实现监控及拍照功能调试
- 11用c++写一个蓝屏代码
- 12从JDK8源码中看ArrayList和LinkedList的区别
- 13idea 1、报错java: 找不到符号 符号: 变量 log 2、转换成Maven项目
- 14在openwrt使用C语言增加ubus接口（包含C uci操作）
- 15Spring 解决循环依赖
- 16SpringMVC——基于MVC架构的Spring框架
- 17Andy‘s First Dictionary C++ STL set应用
- 18动态内存管理
- 19我的创作纪念日
- 20Docker自定义镜像-Dockerfile
热门相关搜索路由器设置 木托盘 宝塔面板 儿童python教程 心情低落 朋友圈 vim 双一流学科 专升本 我的学校 日记学校 西点培训学校 汽修学校 情书 化妆学校 塔沟武校 异形模板 西南大学排名 最精辟人生短句 6步教你追回被骗的钱 南昌大学排名 清朝十二帝 北京印刷学院排名 北方工业大学排名 北京航空航天大学排名 首都经济贸易大学排名 中国传媒大学排名 首都师范大学排名 中国地质大学(北京)排名 北京信息科技大学排名 中央民族大学排名 北京舞蹈学院排名 北京电影学院排名 中国戏曲学院排名 河北政法职业学院排名 河北经贸大学排名 天津中德应用技术大学排名 天津医学高等专科学校排名 天津美术学院排名 天津音乐学院排名 天津工业大学排名 北京工业大学耿丹学院排名 北京警察学院排名 天津科技大学排名 北京邮电大学(宏福校区)排名 北京网络职业学院排名 北京大学医学部排名 河北科技大学排名 河北地质大学排名 河北体育学院排名名师互学网 版权所有 (c)2021-2022 ICP备案号：晋ICP备2021003244-6号
