有时候,我们需要显示一些对象的信息,当对象较多时,据需要分页游览,自定义相关的视图函数比较麻烦,幸好Django自己提供了具有这一功能的通用视图函数:list_detail.object_list(....)
先解释一下其工作原理:这个函数根据当前所需显示的页(page)和每页显示的对象数目(pagonateed_by),来选出应该显示的对象,并用相应的模板来显示。
下面我将根据项目的构建过程来说明自动分页功能的实现:
1.由于试图函数的参数较多,所以直接在URlPatterns中定义有些不美观。所以最好自己写一个视图函数,然后在其中调用这个试图函数。自定义的视图函数只要以一个返回语句即可,如下:
def msg_list_pag(request):
return list_detail.object_list(
request,
queryset=Msg.objects.order_by('-id'),
paginate_by=ITEM_PER_PAGE,
template_name='msg_list_pag.html',
template_object_name='msg'
)
各个参数解释如下:
request:视图函数必备,不解释
queryset:所需显示的对象的集合
paginate_by:整型,每页显示的对象数目,当总的对象数目<=该数字时,模板参数is_paginated的值为False
template_name:需要渲染的模板
template_object_name:默认是'object',这个取决于模板中模板变量所使用的名称,这个模板变量貌似是一个保存
queryset中所有对象的列表。该函数自动添加后缀‘_list’,所以的模板中的变量是'object_list'
这个函数的参数很多,这里只列举部分常用的。
2.自定义模板:这个视图函数对模板变量的命名有一定要求,举起如下:
Context:
object_list
list of objects,这里不一定是object_list,根据template_object_name来确定
is_paginated
are the results paginated? 当总的对象数目<=该数字时,模板参数is_paginated的值为False
results_per_page
number of objects per page (if paginated)
has_next
is there a next page?
has_previous
is there a prev page?
page
the current page
next
the next page
previous
the previous page
pages
number of pages, total
hits
number of objects, total
last_on_page
the result number of the last of object in the
object_list (1-indexed)
first_on_page
the result number of the first object in the
object_list (1-indexed)
page_range:
A list of the page numbers (1-indexed).
①显示对象用for循环,依次取出每个对象进行显示,格式自定义这里做个参考:
{% for msg in msg_list%}
<tr>
<td>msg.属性1</td>
。。。。。。。。。
</tr>
②如果要实现如图的定位功能
使用模板变量page和pages来显示当前页数和总共页数,重点说‘一下页’和'到第x页'的实现:
下一页:
<a href="?page={{next}}">下一页>></a>
到第x页:
<form action="" method="get">
<label for="id_page">到底
<input type="text" name="page">
<input type="submit" value="确认">
</form>
解释:视图函数将通过request.GET来从form或url获取'page'的值: request.GET.get('page',1)
(或request.GET['page']),然后生成一个paginater对象,通过该对 象来显示当前页数所需显示的对象