Django-实现分页

视图核心代码

# 获取所有文章
post = Post.objects.all()
# 获取p的值默认为1
p = request.GET.get('p', 1)
# 第一个参数为 必选参数,代表需要进行分页处理的数据,参数值可以为列表、元组或ORM查询的数据对象等。
# 第二个参数为 必选参数,设置每一页的数据量,参数值必须为整型
paginator = Paginator(post, 4)
try:
    # page():根据当前页数对参数object_list进行切片处理,获取页数所对应的数据信息,函数返回值调用_get_page()。
    pages = paginator.page(p)
except PageNotAnInteger:
    pages = paginator.page(1)
except EmptyPage:
    # num_pages():获取分页后的总页数。
    pages = paginator.page(paginator.num_pages)

前端核心代码

  <nav class="pagination" style="">
	<ul>
        //has_previous():判断当前页数是否存在上一页
        {% if pages.has_previous %}
        //previous_page_number():如果当前页数存在上一页,就输出上一页的页数,否则抛出EmptyPage异常。
        <li class="next-page"><a href="?p={{ pages.previous_page_number }}">上一页</a></li>
        {% endif %}
	  <li class="prev-page"></li>
        //page_range():将分页后的总页数生成可循环对象。
    {% for page in pages.paginator.page_range  %}
        {% if pages.number == page %}
	  <li class="active"><span>{{ page }}</span></li>

        {% elif pages.number|add:'-1' == page or pages.number|add:'1' == page %}
            <li><a href="?p={{ page }}">{{ page }}</a></li>
        {% endif %}
    {% endfor %}
        //has_next():判断当前页数是否存在下一页。
    {% if pages.has_next %}
        //next_page_number():如果当前页数存在下一页,就输出下一页的页数,否则抛出EmptyPage异常。
	  <li class="next-page"><a href="?p={{ pages.next_page_number }}">下一页</a></li>
    {% endif %}
	</ul>
  </nav>

Paginator类一共定义了4个初始化参数和8个类方法,每个初始化参数和类方法的说明如下:

  • object_list:必选参数,代表需要进行分页处理的数据,参数值可以为列表、元组或ORM查询的数据对象等。
  • per_page:必选参数,设置每一页的数据量,参数值必须为整型。
  • orphans:可选参数,如果最后一页的数据量小于或等于参数orphans的值,就将最后一页的数据合并到前一页的数据。比如有23行数据,若参数per_page=10、orphans=5,则数据分页后的总页数为2,第一页显示10行数据,第二页显示13行数据。
  • allow_empty_first_page:可选参数,是否允许第一页为空。如果参数值为False并且参数object_list为空列表,就会引发EmptyPage错误。
  • validate_number():验证当前页数是否大于或等于1。
  • get_page():调用validate_number()验证当前页数是否有效,函数返回值调用page()。
  • page():根据当前页数对参数object_list进行切片处理,获取页数所对应的数据信息,函数返回值调用_get_page()。_
  • get_page():调用Page类,并将当前页数和页数所对应的数据信息传递给Page类,创建当前页数的数据对象。
  • count():获取参数object_list的数据长度。
  • num_pages():获取分页后的总页数。
  • page_range():将分页后的总页数生成可循环对象。
  • _check_object_list_is_ordered():如果参数object_list是ORM查询的数据对象,并且该数据对象的数据是无序排列的,就提示警告信息。

从Paginator类定义的get_page()、page()和_get_page()得知,三者之间存在调用关系

Django-实现分页_django

Page类的定义过程,它一共定义了3个初始化参数和7个类方法,每个初始化参数和类方法的说明如下:

  • object_list:必选参数,代表已切片处理的数据对象。
  • number:必选参数,代表用户传递的页数。
  • paginator:必选参数,代表Paginator类的实例化对象。
  • has_next():判断当前页数是否存在下一页。
  • has_previous():判断当前页数是否存在上一页。
  • has_other_pages():判断当前页数是否存在上一页或者下一页。
  • next_page_number():如果当前页数存在下一页,就输出下一页的页数,否则抛出EmptyPage异常。
  • previous_page_number():如果当前页数存在上一页,就输出上一页的页数,否则抛出EmptyPage异常。
  • start_index():输出当前页数的第一行数据在整个数据列表的位置,数据位置从1开始计算。
  • end_index():输出当前页数的最后一行数据在整个数据列表的位置,数据位置从1开始计算。