8.1 释义
表单集即多个表单的集合,从此处可以看出表单集(FormSet)由表单(Form)构成。
通过表单集,可一键添加多个表单的数据,如在一个页面一键提交多个用户或商品的信息。
在没有使用表单集时,想在一个页面提交多个表单时,只能采用如下的办法:
- 定义一个表单
- 在一个页面中多次使用这个表单
8.2 非表单集的示例
示例如下:
提交须创建好Django项目chapter07,并创建一个应用form01
第一步:应用form01下,创建forms.py模块,在其中定义表单类
from django import forms
# 继承Form类实现表单
class BookForm(forms.Form):
book_name = forms.CharField(max_length=100, label='书名')
book_price = forms.FloatField(max_value=1000, label='价格')
第二步:在from01应用下定义视图函数,分别处理get与post请求
from django.http import HttpResponse
from django.shortcuts import render
from form01.forms import BookForm, BookFormSet
from form01.models import Book
def book(request):
"""分别处理get与post请求"""
if request.method == 'POST':
print(request.POST)
book_form01 = BookForm(request.POST, prefix='book_form01')
book_form02 = BookForm(request.POST, prefix='book_form02')
if book_form01.is_valid():
print(book_form01.prefix)
name = book_form01.cleaned_data['book_name']
price = book_form01.cleaned_data['book_price']
return HttpResponse(f'书名: {name}, 价格: {price}')
if book_form02.is_valid():
print(book_form02.prefix)
name = book_form02.cleaned_data['book_name']
price = book_form02.cleaned_data['book_price']
return HttpResponse(f'书名: {name}, 价格: {price}')
else:#get请求
print('get 请求')
book_form01 = BookForm(prefix='book_form01')
book_form02 = BookForm(prefix='book_form02')
context = {'book_form01': book_form01, 'book_form02': book_form02}
return render(request, 'form01.html', context)
第三步:templates文件夹下创建from01.html
<body>
<form method="post" action="/form01/book/">
{% csrf_token %}
{{ book_form01 }}
<input type='submit' value="提交">
</form>
<form method="post" action="/form01/book/">
{% csrf_token %}
{{ book_form02 }}
<input type='submit' value="提交">
</form>
</body>
第四步:配置froms应用子路由
from django.urls import path
from form01 import views
urlpatterns = [
path('book/', views.book),
]
第五步:配置根路由
from django.urls import path, include
from app01.views import login
urlpatterns = [
path('form01/', include('form01.urls')),
]
从以上示例可以看出,如果想要把页面提交的表单从2个变成3个,既要修改视图函数,又要修改HTML页面,耦合度较高,不利于扩展。
表单集可以很好地解决上述问题。
使用表单集的步骤如下:
- 使用表单创建表单集。创建表单集用到函数有
formset_factory
、modelformset_factory
,formset_factory
用于创建没有模型关联的表单集,modelformset_factory
用于创建与模型有关联的表单集。 - 定义视图函数,处理表单集的数据,分为get与post
- 定义路由
- 定义前端模板
8.3 表单集示例
第一步:froms应用下forms.py中创建表单
# formset_factory():批量处理多个相同类型的表单,将单个表单类动态转换为支持多实例操作的表单集类
# extra:想要显示空表单的数量
BookFormSet = formset_factory(BookForm,extra=3)
第二步:定义视图函数,这里通过for循环一次性处理了所有的表单数据,处理更简单
def book_formset(request):
if request.method == 'POST':#post请求
formset = BookFormSet(request.POST)
if formset.is_valid():
# 取表单数据的操作
for form in formset:
print(f"书名:{form.cleaned_data['book_name']},价格:{form.cleaned_data['book_price']} ")
else:
formset = BookFormSet()
return render(request, 'form02.html', {'formset': formset})
第三步:定义路由,新增路由模式
path('formset/', views.book_formset)
第四步:定义模板form02.html
<body>
<form method="POST" action=".">
{% csrf_token %}
{{ formset}}
<input type="submit" value="提交"/>
</form>
</body>
重点总结:
- 要掌握创建表单集的函数
formset_factory()
,此函数返回一个类,而不是一个对象,其参数extra=3可设置空表单的数量,后台收到get请求时会返回相应数量的空表单,通过页面可以看出来。 - 后台收到post请求接收到表单集的数据时,要通过for循环遍历得到form表单,再通过表单的
cleaned_data
属性取到数据,进一步加工处理。