什么是表单：
表单是搜集用户数据信息的各种表单元素的集合，作用是实现网页上的数据交互，用户在网站输入信息，然后提交到网站服务器端进行处理（如数据录入和用户登录、注册等）。
用户表单是web开发的一项基本功能,Django的表单功能有Form类实现，主要分为两种：django.forms.Form和django.forms.ModelForm。前者是一个基础的表单功能，后者是在前者的基础上结合模型所生成的数据表单。
表单
传统的表单生成方式是在模板文件总编写HTML代码实现，在HTML语言中，表单由标签实现。表单生成方式如下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>表单</title>
</head>
<body>
<form>
First name:<br>
<input type="text" name="firstname">
<br>
Last name:<br>
<input type="text" name="lastname">
</form>
</body>
</html>
浏览器显示：
这里我就要强推w3school，这个网址学前端必备啊，这里不多说感兴趣可以自己去看，也有python都有案例的。
一个完整的表单主要有4个组成部分：提交地址、请求方式、元素控件和提交按钮。其说明如下：
1、提交地址用于设置用户提交的表单数据应有那个URL接收和处理，由控件的属性action决定。当用户向服务器提交数据时，若属性action为空，则提交的数据应有当前的URL来接收和处理，否则网页会跳转到属性action所指向的URL地址。
2、请求方式用于设置表单的提交方式，通常是GET请求或POST请求，由控件的属性method决定。
3、元素控件是供用户输入数据信息的输入框。由HTML的控件实现，其控件属性type用于设置输入框的类型，常用的输入框类型有文本框、下拉框和复选框等。
4、提交按钮供用户数据到服务器，该按钮也是由HTML的控件实现的。但该按钮具有一定的特殊性，因此不归纳到元素控件的范围内。
在模板中直接写表单文件是一个最简单最直接的方法，如果表单元素较多，会在无形之中增加模板的代码量，这样对日后的维护和更新造成极大的不便。为了简化表单的实现过程和提高表单的灵活性，Django提供了完善的表单功能。
在MyDjango的index中添加了空白文件form.py，该文件主要用于编写表单的实现功能，文件夹可自行命名；同时在文件夹templates中添加模板文件data_form.html，该文件用于将表单的数据显示到网页上。最后在文件form.py、views.py和data_form.html中分别添加一下代码
index(App)下的form.py，没有这个文件就新建
定义ProductForm表单对象
from django import forms
from .models import *
class ProductForm(forms.Form):
name = forms.CharField(max_length=20, label='名字',)
weight = forms.CharField(max_length=50, label='重量')
size = forms.CharField(max_length=50, label='尺寸')
#设置下拉框的值
choices_list = [(i+1,v['type_name']) for i,v in enumerate(Type.objects.values('type_name'))]
type = forms.ChoiceField(choices=choices_list, label='产品类型')
index(App)下的view.py
将表单ProductForm实例化并将其传递到模板中生成网页内容
from .form import *
def index(request):
product = ProductForm()
return render(request, 'data_form.html', locals())
index下的templates下的html文件data_form.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
{% if product.errors %}
<p>
数据出错啦，错误信息：{{ product.errors }}
</p>
{% else %}
<form action="" method="post">
{% csrf_token %}
<table>
{{ product.as_table }}
</table>
<input type="submit" value="提交">
</form>
{% endif %}
</body>
</html>
上述代码演示了Django内置表单功能的使用方法，主要由form.py、views.py和data_form.html共同实现，说明如下：
1、在form.py中定义表单ProductForm，表单以类的形式表示。在表单中定义了不同类型的类属性，这些属性在表单中称为表单字段，每个表单字段代表HTML里的一个控件，这是表单的基本组成单位。
2、在views.py中导入form.py所定义的ProductForm类，在视图函数index中对ProductForm实例化生成对象product，再将对象product传递给模板data_form.html。
3、模板data_form.html将对象product以HTML的<table的形式展现在网页上。
表单的定义
Django的表单功能主要是通过定义表单类，再由类的实例化生成HTML的表单元素控件，这样可以在模板中减少HTML的硬编码。每个HTML的表单元素控件由表单字段来决定，代码如下：
表单类ProductForm的表单字段name
name = forms.CharField(max_length=20, label='名字',)
表单字段name所生成的HTML元素控件
<tr>
<th><label for="id_name">名字:</label></th>
<td><input type="text" name="name" id="id_name" required maxlength="20"></td>
</tr>
从表单字段转换HTML元素控件可以发现：
1、字段name的参数label转换成HTML的标签
| 字段 | 说明 |
|---|---|
| BooleanField | 复选框，如果字段带有required=True，复选框被勾选上 |
| CharField | 文本框，参数max_length和min_length分别设置输入长度 |
| ChoiceField | 下拉框，参数choices设置数据内容 |
| TypedChoiceField | 与ChoiceField相似，但比ChoiceField多出参数coerce和empty_value，分别代表强制转换数据类型和用于表示空值，默认为空字符串 |
| DateField | 文本框，具有验证日期格式的功能，参数input_formats设置日期格式 |
| EmailField | 文本框，验证输入数据是否为合法的邮箱地址。可选参数为max_length和min_length |
| FileField | 文件上传功能，参数max_length和allow_empty_file分别用于设置文件名的最大长度和文件内容是否为空 |
| FilePathField | 在特定的目录选择并上传文件，参数path是必需参数，参数recursive、match、allow_files和allow_folders为可选参数 |
| FloatField | 验证数据是否为浮点数 |
| ImageField | 验证文件是否为Pillow库可识别的图像格式 |
| ImtegerField | 验证数据是否为整型 |
| GenericIPAddressField | 验证数据是否为有效数值 |
| SlugField | 验证数据是否只包括字母、数字、下划线及字符 |
| TimeField | 验证数据是否为datetime.time或指定特定时间格式的字符串 |
| URLField | 验证数据是否为有效的URL地址 |
表单字段除了转换HTML控件之外，还具有一定的数据格式规范，数据格式规范主要由字段类型和字段参数共同实现。每个不同类型的表单字段都有一些自己特殊的参数，但每个表单字段都具有如下表的共同参数：
| 参数 | 说明 |
|---|---|
| Required | 输入数据是否为空，默认值为True |
| Widget | 设置HTML控件的样式 |
| Label | 用于生成Label标签或显示内容 |
| Initial | 设置初始值 |
| help_text | 设置帮助提示信息 |
| error_messages | 设置错误信息，以字典格式表示：{‘required’: ‘不能为空’, ‘invalid’: '格式错误‘} |
| show_hidden_initial | 值为True/False，是否在当前差距后面再加一个隐藏的且具有默认值的插件(可用于检验两次输入值是否一致) |
| Validators | 自定义数据验证规则。以列表格式表示，列表元素为函数命名 |
| Localize | 值为True/False，是否支持本地和，如不同时区显示相应的时间 |
| Disabled | 值为True/False，是否可以编辑 |
| label_suffix | Label内容后缀，在Label后添加内容 |
根据上面表的参数说明，对form.py的表单ProductForm的字段进行优化：
from django import forms
from .models import *
from django.core.exceptions import ValidationError
#自定义数据验证函数
def weight_validate(value):
if not str(value).isdigit():
raise ValidationError('请输入正确的重量')
class ProductForm(forms.Form):
#设置错误信息并设置样式
name = forms.CharField(max_length=20,
label='名字',
widget=forms.widgets.TextInput(attrs={'class': 'c1'}),
error_messages={'required': '名字不能为空'},)
#使用自定义数据验证函数
weight = forms.CharField(max_length=50,
label='重量',
validators=[weight_validate])
size = forms.CharField(max_length=50, label='尺寸')
#获取数据库数据
choices_list = [(i+1,v['type_name']) for i,v in enumerate(Type.objects.values('type_name'))]
#设置CSS样式
type = forms.ChoiceField(widget=forms.widgets.Select(attrs={'class':'type','size':'4'}),
choices=choices_list, label='产品类型')
优化的代码分别使用了参数widget、label、error_messages和validators，这4个参数是实际开发中常用的参数，参数说明如下：
1、参数widget是一个forms.widgets对象，其作用是设置表单字段的CSS样式。widget的对象类型应与表单字段类型相符合，如果字段类型为CharField和widget的对象类型为forms.widgets.TextInput，这两者的含义与作用是一致的，都代表文本输入框；如果字段类型为ChoiceField和widget的对象类型为forms.widgets.TextInput，前者是下拉选择框，后者是文本输入框，那么在网页上就会优先显示为文本输入框。
2、参数label会转换成HTML的标签
def index(request):
#GET请求
if request.method == 'GET':
product = ProductForm()
return render(request, 'data_form.html', locals())
#POST请求
else:
product = ProductForm(request.POST)
if product.is_valid():
#获取网页空间name的数据
#方法一
name = product['name']
#方法二
#cleaned_data将控件name的数据进行清洗，转换成Python数据类型
cname = product.cleaned_data['name']
return HttpResponse('提交成功')
else:
#将错误信息输出，error_msg是将错误信息以json格式输出
error_msg = product.errors.as_json()
print(error_msg)
return render(request, 'data_form.html', locals())
1、首先判断用户的请求方式，不同的请求方式执行不同的程序处理。函数index分别对GET和POST请求做了不同的响应处理。
2、用户在浏览器中访问http://127.0.0.1:8000/index/，等同于向MyDjango发送一个GET请求，函数index将表单ProductForm实例化并传递给模板，由模板引擎生成HTML表单返回给用户。
3、当用户在网页上输入相关信息后单击"提交"按钮，等同于向MyDjango发送一个POST请求，函数index首先获取表单数据对象product，然后由is_valid()对数据对象product进行数据验证。
4、如果验证成功，可以使用product[‘name’]或product.cleaned_data[‘name’]方法来获取用户在某个控件上的输入值。只要将获取到的输入值和模型相互使用，就可以实现表单与模型的信息交互。
5、如果验证失败，使用errors.as_json()方法获取验证失败的信息，然后将验证失败的信息通过模板返回给用户。
模板data_form.html的表单是使用HTML的table标签展现在网页上，除此之外，表单还可以使用其他HTML标签展现，只需将模板data_form.html的对象product使用以下方法即可生成其他HTML标签
#将表单生成HTML的ul标签
{{ product.as_ul }}
#将表单生成HTML的p标签
{{ product.as_p }}
#生成单个HTML元素控件
{{ product.type }}
#获取表单字段的参数label属性值
{{ product.type.label }}
模型与表单
Django的表单分为两种：django.forms.Form和django.forms.ModelForm。前者是一个基础的表单功能，后者是在前者的基础上结合模型所生成的数据表单。数据表单是将模型的字段转换成表单的字段，再从表单的字段生成HTML的元素控件，这是日常开发中常用的表单之一。
#forms.py里面的数据库表单
class ProductModelForm(forms.ModelForm):
#添加模型外的表单字段
productId = forms.CharField(max_length=20, label='产品序号')
#模型与表单设置
class Meta:
#绑定模型
model = Product
#fields属性用于设置转换字段，’__all__'是将全部模型字段转换成表单字段
#fields = '__all__'
fields = ['name','weight','size','type']
#exclude用于禁止模型字段转换表单字段
exclude = []
#labels设置HTML元素控件的label标签
labels = {
'name': '产品名称',
'weight': '重量',
'size': '尺寸',
'type': '产品类型'
}
#定义widgets，设置表单字段的CSS样式
widgets = {
'name': forms.widgets.TextInput(attrs={'class': 'cl'}),
}
#定义字段的类型，一般情况下模型的字段会自动转换成表单字段
field_classes = {
'name': forms.CharField
}
#帮助提示信息
help_texts = {
'name': ''
}
#自定义错误信息
error_messages = {
#__all__设置全部错误信息
'__all__': {'required': '请输入内容',
'invalid': '请检查输入内容'},
#设置某个字段的错误信息
'weight': {'required': '请输入重复数值',
'invalid': '请检查数值是否正确'}
}
#自定义表单字段weight的数据清洗
def clean_weight(self):
#获取字段weight的值
data = self.cleaned_data['weight']
return data+'g'
上述代码中，表单类ProductModelForm可分为三大部分：添加模型外的表单字段、模型与表单设置和自定义表单字段weight的数据清洗函数，说明如下：
1、添加模型外的表单字段是在模型已有的字段下添加额外的表单字段。
2、模型与表单设置是将模型的字段转换成表单字段，由类Meta的属性实现两者的字段转换。
3、自定义表单字段weight的数据清洗函数只只是用于字段weight的数据清洗。
模型字段转换成表单字段主要在类Meta中实现。
| 属性 | 说明 |
|---|---|
| Model | 必需属性，用于绑定Model对象 |
| Fields | 必须属性，设置模型内那些字段转换成表单字段。属性值为’all’代表整个模型的字段，若设置一个或多个，使用列表或元组的数据格式表示，列表或元组里的元素是模型的字段名 |
| Exclude | 可选属性，与fields相反，禁止模型内那些字段转换成表单字段。属性值以列表或元组表示，若设置了该属性，则属性fields可以不用设置 |
| Labels | 可选属性，设置表单字段里的参数label。属性值以字典表示，字典里的键是模型的字段 |
| Widgets | 可选属性，设置表单字段里的参数widget |
| field_classes | 可选属性，将模型的字段类型重新定义为表单字段类型，默认情况下，模型字段类型会字段转换为表单字段类型 |
| help_texts | 可选属性，设置表单字段里的参数 |
| error_messages | 可选属性，设置表单字段里的参数error_messages |
一些较为特殊的模型字段在转换表单时会有不同的处理方式。例如模型字段的类型为AutoField，该字段在表单中不存在对应的表单字段；模型字段类型为ForeignKey和ManyToManyField，在表单中对应的表单字段为ModelChoiceField和ModelMultipleChoiceField。
自定义表单字段weight的数据清洗函数是在视图函数中使用cleaned_data方法时，首先判断当前清洗的表单字段是否已定义数据清洗函数。例如上述的clean_weight函数，在清洗表单字段weight的数据时会自动执行该自定义函数。在自定义数据清洗函数时，必须以"clean_字段名"的格式作为函数名，而且函数必须有return返回值。如果在函数中设置ValidationError了异常抛出，那么该函数可视为带有数据验证的清洗函数。
数据表单的使用
现在使用前面的data_form.html，在MyDjango的url.py和views.py中分别定义新的URL地址和视图函数：
url.py添加代码如下：
path('<int:id>.html', views.models_index),
views.py添加代码如下：
def models_index(request, id):
if request.method == 'GET':
instance = Product.objects.filter(id=id)
# 判断数据是否存在
if instance:
product = ProductModelForm(instance=instance[0])
else:
product = ProductModelForm()
return render(request, 'data_form.html', locals())
else:
product = ProductModelForm(request.POST)
if product.is_valid():
#获取weight的数据，并通过clean_weight进行清洗，转换成Python数据类型
weight = product.cleaned_data['weight']
#数据保存方法一
#直接将数据保存到数据库
#product.save()
#save方法设置commit=False，将生成数据库对象product_db，然后对该对象的属性值修改并保存
product_db = product.save(commit=False)
product_db.name = '我的iPhone'
product_db.save()
#数据保存方法三
#save_m2m()方法用于保存ManyToMany的数据模型
#product.save_m2m()
return HttpResponse('提交成功！weight清洗后的数据为：'+weight)
else:
#将错误信息输出，error_msg是将错误信息以json格式输出
error_msg = product.errors.as_json()
print(error_msg)
return render(request, 'data_form.html', locals())
1、首先判断用户的请求方式，不同的请求方式执行不同的处理程序。代码分别对GET和POST请求做了不同的响应处理。
2、若当前请求为GET请求，函数根据URL传递的变量id来查找模型Product的数据，如果数据存在，模型的数据以参数的形式传递给表单ProductModelForm的参数instance，在生成网页时，模型数据会填充到对应的元素控件上。
3、若当前请求为POST请求，函数首先对表单数据进行验证，若验证失败，则返回失败信息；若验证成功，则使用cleaned_data方法对字段weight进行清洗，字段weight清洗由自定义函数clean_weight完成，最后将表单数据保存到数据库，保存数据有三种方式，具体说明可看代码注释，运行结果如下：
这个是我数据库里的表
我们试着提交一下，输入产品序号，
表单的初始化有4种方法，每一种方法都有自己的使用方法：
(1) 在视图函数中对表单类进行实例化，可以设置实例化对象的参数initial。例如ProductModelForm(initital={‘name’:value})，参数值以字典的格式表示，字典的键为表单的字段名，这种方法适用于所有表单类。
(2) 在表单类中进行实例化，如果初始化的数据是一个模型对象的数据，可以设置参数instanse，这种方法只是用于ModelForm，如ProductModelForm(instanse=instanse)。
(3) 定义表单字段时，可以对表单字段设置初始化参数initial，此方法不适用于ModelForm，如name=forms.CharField(initial=value)。
(4) 重写表单类的初始化函数__init__()，适用于所有表单类，如在初始化函数__init__()中设置self.fields[‘name’].initial=value。
下拉框的数据是一个模型Type对象，而下拉框是由模型Product的外键type所生成的，外键type指向模型Type。因此，要解决下拉框的数据问题，可以从定义模型或者定义表单这两方面解决。
定义模型是在定义模型Type时，设置该模型的返回值。当有外键指向模型Type时，模型Type会将返回值返回给外键。在模型中通过重写__str__函数可以设置模型的返回值：
class Type(models.Model): #创建产品分类表
id = models.AutoField(primary_key=True) #数据类型为整形且为主键
type_name = models.CharField(max_length=20)
#设置返回值，若不设置，则默认返回Type对象
def __str__(self):
return self.type_name
如果存在多个下拉框，而且每个下拉框的数据分别取不同一个模型的不同字段，那么重写__str__函数可能不太可行。遇到这种情况，可以在定义表单类的时候重写初始化函数__init__()：
class ProductModelForm(forms.ModelForm):
#方法四：重写ProductModelForm类的初始化函数__init__
def __init__(self, *args, **kwargs):
super(ProductModelForm, self).__init__(*args, **kwargs)
#设置下拉框的数据
type_obj = Type.objects.values('type_name')
choices_list = [(i+1,v['type_name']) for i,v in enumerate(Type.objects.values('type_name'))]
self.fields['type'].choices = choices_list
#初始化字段name
self.fields['name'].initial = '我的手机'
实质上数据保存只有save()和save_m2m()方法实现，在上述代码中所演示的三种保存方式，前两者是save()的参数commit的不同而导致保存方式有所不同。如果参数commit为True，直接将表单数据保存到数据库；如果参数commit为False，这时将生成一个数据库对象，然后可以对该对象进行增删改查等数据操作，再将修改后的数据保存到数据库中。注意的是save()只适合于将数据保存在非多对多数据关系的数据表，而save_m2m()只适合将数据保存在多对多数据关系的数据表。
本篇博客参考Django的建站基础表单与模型
扫一扫
403
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
