{"title":"分页器","version":"3.2","locale":"zh-hans","docname":"ref/paginator","url":"/zh-hans/3.2/ref/paginator/","canonical":"https://djangodocs.dev/zh-hans/3.2/ref/paginator/","summary":"Django 提供了一些类来帮助你管理分页数据 ——也就是说，数据被分割在几个页面上，并带有 “上一页／下一页” 的链接。这些类位于 django/core/paginator.py 中。","html":"<h1>分页器<a class=\"heading-anchor\" href=\"#paginator\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Django 提供了一些类来帮助你管理分页数据 ——也就是说，数据被分割在几个页面上，并带有 “上一页／下一页” 的链接。这些类位于 <a class=\"extlink-source reference external\" href=\"https://github.com/django/django/blob/stable/3.2.x/django/core/paginator.py\">django/core/paginator.py</a> 中。</p>\n<p>For examples, see the <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/pagination/\"><span class=\"doc\">Pagination topic guide</span></a>.</p>\n<section id=\"paginator-class\">\n<span id=\"module-django.core.paginator\"></span><h2><code class=\"docutils literal notranslate\">Paginator</code> 类<a class=\"heading-anchor\" href=\"#paginator-class\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">Paginator</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">object_list</em>, <em class=\"sig-param\">per_page</em>, <em class=\"sig-param\">orphans<span class=\"o\">=</span><span class=\"default_value\">0</span></em>, <em class=\"sig-param\">allow_empty_first_page<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>当使用 <code class=\"docutils literal notranslate\">len()</code> 或直接迭代时，分页器的作用就像一个 <a class=\"reference internal\" href=\"#django.core.paginator.Page\" title=\"django.core.paginator.Page\"><code class=\"xref py py-class docutils literal notranslate\">Page</code></a> 的序列。</p>\n<aside class=\"version-note version-changed\" data-version=\"3.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 3.1</p><p>增加了对 <code class=\"docutils literal notranslate\">Paginator</code> 迭代的支持。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.object_list\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">object_list</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.object_list\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>必要的。一个列表、元组、<code class=\"docutils literal notranslate\">QuerySet</code> 或其他具有 <code class=\"docutils literal notranslate\">count()</code> 或 <code class=\"docutils literal notranslate\">__len__()</code> 方法的可切片对象。为了实现一致的分页，<code class=\"docutils literal notranslate\">QuerySet</code> 应该是有序的，例如使用 <a class=\"reference internal\" href=\"/zh-hans/3.2/ref/models/querysets/#django.db.models.query.QuerySet.order_by\" title=\"django.db.models.query.QuerySet.order_by\"><code class=\"xref py py-meth docutils literal notranslate\">order_by()</code></a> 子句或使用模型上的默认 <a class=\"reference internal\" href=\"/zh-hans/3.2/ref/models/options/#django.db.models.Options.ordering\" title=\"django.db.models.Options.ordering\"><code class=\"xref py py-attr docutils literal notranslate\">ordering</code></a>。</p>\n<aside class=\"admonition-performance-issues-paginating-large-queryset-s admonition\" role=\"note\">\n<p class=\"admonition-title\">对大型 <code class=\"docutils literal notranslate\">QuerySet</code> 进行分页的性能问题</p>\n<p>如果你使用的 <code class=\"docutils literal notranslate\">QuerySet</code> 有非常多的项目，在某些数据库上请求高页数可能会很慢，因为产生的 <code class=\"docutils literal notranslate\">LIMIT</code> ／ <code class=\"docutils literal notranslate\">OFFSET</code> 查询需要计算 <code class=\"docutils literal notranslate\">OFFSET</code> 记录的数量，随着页数的增加，需要的时间也就越长。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.per_page\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">per_page</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.per_page\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>必要的。一个页面中包含的最大项目数，不包括 orphans（参见下面的 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.orphans\" title=\"django.core.paginator.Paginator.orphans\"><code class=\"xref py py-attr docutils literal notranslate\">orphans</code></a> 可选参数）。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.orphans\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">orphans</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.orphans\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>可选的。当你不希望最后一页的项目数量很少时，使用这个选项。如果最后一页的项目数量通常小于或等于 <code class=\"docutils literal notranslate\">orphans</code>，那么这些项目将被添加到前一页（成为最后一页），而不是让这些项目单独留在一页上。例如，如果有 23 个条目，<code class=\"docutils literal notranslate\">per_page=10</code>，<code class=\"docutils literal notranslate\">orphans=3</code>，则会有两页；第一页有 10 个条目，第二页（也是最后一页）有 13 个条目。<code class=\"docutils literal notranslate\">orphans</code> 默认为 0，这意味着页面永远不会合并，最后一页可能只有一个项目。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.allow_empty_first_page\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">allow_empty_first_page</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.allow_empty_first_page\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>可选的。是否允许第一页为空。 如果 <code class=\"docutils literal notranslate\">False</code> 并且 <code class=\"docutils literal notranslate\">object_list</code> 是空的，则会出现 <code class=\"docutils literal notranslate\">EmptyPage</code> 错误。</p>\n</dd></dl>\n\n<section id=\"methods\">\n<h3>方法<a class=\"heading-anchor\" href=\"#methods\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.get_page\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">get_page</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">number</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.get_page\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回一个给定的基于 1 索引的 <a class=\"reference internal\" href=\"#django.core.paginator.Page\" title=\"django.core.paginator.Page\"><code class=\"xref py py-class docutils literal notranslate\">Page</code></a> 对象，同时处理超出范围和无效的页码。</p>\n<p>如果页数不是数字，它返回第一页。如果页码为负数或大于页数，则返回最后一页。</p>\n<p>只有当你指定了 <code class=\"docutils literal notranslate\">Paginator(..., allow_empty_first_page=False)</code> 并且 <code class=\"docutils literal notranslate\">object_list</code> 为空时，才会引发 <a class=\"reference internal\" href=\"#django.core.paginator.EmptyPage\" title=\"django.core.paginator.EmptyPage\"><code class=\"xref py py-exc docutils literal notranslate\">EmptyPage</code></a> 异常。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.page\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">page</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">number</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.page\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns a <a class=\"reference internal\" href=\"#django.core.paginator.Page\" title=\"django.core.paginator.Page\"><code class=\"xref py py-class docutils literal notranslate\">Page</code></a> object with the given 1-based index. Raises\n<a class=\"reference internal\" href=\"#django.core.paginator.PageNotAnInteger\" title=\"django.core.paginator.PageNotAnInteger\"><code class=\"xref py py-exc docutils literal notranslate\">PageNotAnInteger</code></a> if the <code class=\"docutils literal notranslate\">number</code> cannot be converted to an integer\nby calling <code class=\"docutils literal notranslate\">int()</code>. Raises <a class=\"reference internal\" href=\"#django.core.paginator.InvalidPage\" title=\"django.core.paginator.InvalidPage\"><code class=\"xref py py-exc docutils literal notranslate\">InvalidPage</code></a> if the given page number\ndoesn't exist.</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.get_elided_page_range\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">get_elided_page_range</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">number</em>, <em class=\"sig-param\"><span class=\"keyword-only-separator o\"><abbr title=\"Keyword-only parameters separator (PEP 3102)\">*</abbr></span></em>, <em class=\"sig-param\">on_each_side<span class=\"o\">=</span><span class=\"default_value\">3</span></em>, <em class=\"sig-param\">on_ends<span class=\"o\">=</span><span class=\"default_value\">2</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.get_elided_page_range\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><aside class=\"version-note version-added\" data-version=\"3.2\" role=\"note\">\n<p class=\"version-note-title\">New in Django 3.2</p></aside>\n<p>Returns a 1-based list of page numbers similar to\n<a class=\"reference internal\" href=\"#django.core.paginator.Paginator.page_range\" title=\"django.core.paginator.Paginator.page_range\"><code class=\"xref py py-attr docutils literal notranslate\">Paginator.page_range</code></a>, but may add an ellipsis to either or both\nsides of the current page number when <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.num_pages\" title=\"django.core.paginator.Paginator.num_pages\"><code class=\"xref py py-attr docutils literal notranslate\">Paginator.num_pages</code></a> is large.</p>\n<p>The number of pages to include on each side of the current page number is\ndetermined by the <code class=\"docutils literal notranslate\">on_each_side</code> argument which defaults to 3.</p>\n<p>The number of pages to include at the beginning and end of page range is\ndetermined by the <code class=\"docutils literal notranslate\">on_ends</code> argument which defaults to 2.</p>\n<p>For example, with the default values for <code class=\"docutils literal notranslate\">on_each_side</code> and <code class=\"docutils literal notranslate\">on_ends</code>,\nif the current page is 10 and there are 50 pages, the page range will be\n<code class=\"docutils literal notranslate\">[1, 2, '…', 7, 8, 9, 10, 11, 12, 13, '…', 49, 50]</code>. This will result in\npages 7, 8, and 9 to the left of and 11, 12, and 13 to the right of the\ncurrent page as well as pages 1 and 2 at the start and 49 and 50 at the\nend.</p>\n<p>Raises <a class=\"reference internal\" href=\"#django.core.paginator.InvalidPage\" title=\"django.core.paginator.InvalidPage\"><code class=\"xref py py-exc docutils literal notranslate\">InvalidPage</code></a> if the given page number doesn't exist.</p>\n</dd></dl>\n\n</section>\n<section id=\"attributes\">\n<h3>属性<a class=\"heading-anchor\" href=\"#attributes\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.ELLIPSIS\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">ELLIPSIS</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.ELLIPSIS\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><aside class=\"version-note version-added\" data-version=\"3.2\" role=\"note\">\n<p class=\"version-note-title\">New in Django 3.2</p></aside>\n<p>A translatable string used as a substitute for elided page numbers in the\npage range returned by <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.get_elided_page_range\" title=\"django.core.paginator.Paginator.get_elided_page_range\"><code class=\"xref py py-meth docutils literal notranslate\">get_elided_page_range()</code></a>. Default is\n<code class=\"docutils literal notranslate\">'…'</code>.</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.count\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">count</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.count\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>所有页面的对象总数。</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>在确定 <code class=\"docutils literal notranslate\">object_list</code> 中包含的对象数量时，<code class=\"docutils literal notranslate\">Paginator</code> 将首先尝试调用 <code class=\"docutils literal notranslate\">object_list.count()</code>。如果 <code class=\"docutils literal notranslate\">object_list</code> 没有 <code class=\"docutils literal notranslate\">count()</code> 方法，那么 <code class=\"docutils literal notranslate\">Paginator</code> 将回到使用 <code class=\"docutils literal notranslate\">len(object_list)</code>。这允许对象，如 <code class=\"docutils literal notranslate\">QuerySet</code>，在可用时使用更高效的 <code class=\"docutils literal notranslate\">count()</code> 方法。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.num_pages\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">num_pages</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.num_pages\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>总页数。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Paginator.page_range\">\n<span class=\"sig-prename descclassname\">Paginator.</span><span class=\"sig-name descname\">page_range</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Paginator.page_range\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>以 1 为基础的页码范围迭代器，例如产生 <code class=\"docutils literal notranslate\">[1，2，3，4]</code>。</p>\n</dd></dl>\n\n</section>\n</section>\n<section id=\"page-class\">\n<h2><code class=\"docutils literal notranslate\">Page</code> 类<a class=\"heading-anchor\" href=\"#page-class\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>你通常不会手工构建 <code class=\"docutils literal notranslate\">Page</code> 对象 —— 你将通过迭代 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator\" title=\"django.core.paginator.Paginator\"><code class=\"xref py py-class docutils literal notranslate\">Paginator</code></a>，或使用 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.page\" title=\"django.core.paginator.Paginator.page\"><code class=\"xref py py-meth docutils literal notranslate\">Paginator.page()</code></a> 获得它们。</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">Page</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">object_list</em>, <em class=\"sig-param\">number</em>, <em class=\"sig-param\">paginator</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>当使用 <code class=\"docutils literal notranslate\">len()</code> 或直接迭代时，一个页面就像一个 <a class=\"reference internal\" href=\"#django.core.paginator.Page.object_list\" title=\"django.core.paginator.Page.object_list\"><code class=\"xref py py-attr docutils literal notranslate\">Page.object_list</code></a> 的序列。</p>\n</dd></dl>\n\n<section id=\"id1\">\n<h3>方法<a class=\"heading-anchor\" href=\"#id1\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.has_next\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">has_next</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.has_next\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>如果有下一页，返回 <code class=\"docutils literal notranslate\">True</code>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.has_previous\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">has_previous</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.has_previous\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>如果有上一页，返回 <code class=\"docutils literal notranslate\">True</code>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.has_other_pages\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">has_other_pages</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.has_other_pages\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>如果有下一页 <strong>或</strong> 上一页，返回 <code class=\"docutils literal notranslate\">True</code>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.next_page_number\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">next_page_number</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.next_page_number\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回下一页的页码。如果下一页不存在，则引发 <a class=\"reference internal\" href=\"#django.core.paginator.InvalidPage\" title=\"django.core.paginator.InvalidPage\"><code class=\"xref py py-exc docutils literal notranslate\">InvalidPage</code></a>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.previous_page_number\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">previous_page_number</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.previous_page_number\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回上一页的页码。如果上一页不存在，则引发 <a class=\"reference internal\" href=\"#django.core.paginator.InvalidPage\" title=\"django.core.paginator.InvalidPage\"><code class=\"xref py py-exc docutils literal notranslate\">InvalidPage</code></a>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.start_index\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">start_index</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.start_index\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回页面上第一个对象，相对于分页器列表中所有对象的基于 1 的索引。例如，当对一个有 5 个对象的列表进行分页时，每页有 2 个对象，第二页的 <a class=\"reference internal\" href=\"#django.core.paginator.Page.start_index\" title=\"django.core.paginator.Page.start_index\"><code class=\"xref py py-meth docutils literal notranslate\">start_index()</code></a> 将返回 <code class=\"docutils literal notranslate\">3</code>。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.end_index\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">end_index</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.end_index\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回页面上最后一个对象相对于分页器列表中所有对象的基于 1 的索引。例如，当对一个有 5 个对象的列表进行分页时，每页有 2 个对象，第二页的 <a class=\"reference internal\" href=\"#django.core.paginator.Page.end_index\" title=\"django.core.paginator.Page.end_index\"><code class=\"xref py py-meth docutils literal notranslate\">end_index()</code></a> 将返回 <code class=\"docutils literal notranslate\">4</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"id2\">\n<h3>属性<a class=\"heading-anchor\" href=\"#id2\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.object_list\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">object_list</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.object_list\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>此页上的对象列表。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.number\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">number</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.number\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>此页的基于 1 的页码。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.Page.paginator\">\n<span class=\"sig-prename descclassname\">Page.</span><span class=\"sig-name descname\">paginator</span><a class=\"heading-anchor\" href=\"#django.core.paginator.Page.paginator\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>关联的 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator\" title=\"django.core.paginator.Paginator\"><code class=\"xref py py-class docutils literal notranslate\">Paginator</code></a> 对象。</p>\n</dd></dl>\n\n</section>\n</section>\n<section id=\"exceptions\">\n<h2>异常<a class=\"heading-anchor\" href=\"#exceptions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py exception\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.InvalidPage\">\n<em class=\"property\"><span class=\"k\">exception</span> </em><span class=\"sig-name descname\">InvalidPage</span><a class=\"heading-anchor\" href=\"#django.core.paginator.InvalidPage\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>当分页器被传递一个无效的页码时引发异常的基类。</p>\n</dd></dl>\n\n<p><a class=\"reference internal\" href=\"#django.core.paginator.Paginator.page\" title=\"django.core.paginator.Paginator.page\"><code class=\"xref py py-meth docutils literal notranslate\">Paginator.page()</code></a> 方法在请求的页面无效（即不是整数）或不包含任何对象时引发异常。一般来说，只要捕获 <code class=\"docutils literal notranslate\">InvalidPage</code> 异常就够了，但如果你想要更细化，你可以捕获以下任何一种异常。</p>\n<dl class=\"py exception\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.PageNotAnInteger\">\n<em class=\"property\"><span class=\"k\">exception</span> </em><span class=\"sig-name descname\">PageNotAnInteger</span><a class=\"heading-anchor\" href=\"#django.core.paginator.PageNotAnInteger\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>当 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.page\" title=\"django.core.paginator.Paginator.page\"><code class=\"xref py py-meth docutils literal notranslate\">page()</code></a> 的值不是整数时发生该事件。</p>\n</dd></dl>\n\n<dl class=\"py exception\">\n<dt class=\"sig sig-object py\" id=\"django.core.paginator.EmptyPage\">\n<em class=\"property\"><span class=\"k\">exception</span> </em><span class=\"sig-name descname\">EmptyPage</span><a class=\"heading-anchor\" href=\"#django.core.paginator.EmptyPage\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>当 <a class=\"reference internal\" href=\"#django.core.paginator.Paginator.page\" title=\"django.core.paginator.Paginator.page\"><code class=\"xref py py-meth docutils literal notranslate\">page()</code></a> 被赋予一个有效的值，但该页面上没有对象存在时，引发该异常。</p>\n</dd></dl>\n\n<p>这两个异常都是 <a class=\"reference internal\" href=\"#django.core.paginator.InvalidPage\" title=\"django.core.paginator.InvalidPage\"><code class=\"xref py py-exc docutils literal notranslate\">InvalidPage</code></a> 的子类，所以你可以用 <code class=\"docutils literal notranslate\">except InvalidPage</code> 处理这两个异常。</p>\n</section>","rootId":"paginator","toc":[{"title":"Paginator 类","anchor":"paginator-class","children":[{"title":"方法","anchor":"methods","children":[]},{"title":"属性","anchor":"attributes","children":[]}]},{"title":"Page 类","anchor":"page-class","children":[{"title":"方法","anchor":"id1","children":[]},{"title":"属性","anchor":"id2","children":[]}]},{"title":"异常","anchor":"exceptions","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/3.2/ref/"}],"prev":{"docname":"ref/models/database-functions","title":"数据库函数","url":"/zh-hans/3.2/ref/models/database-functions/"},"next":{"docname":"ref/request-response","title":"请求和响应对象","url":"/zh-hans/3.2/ref/request-response/"},"formats":{"html":"/zh-hans/3.2/ref/paginator/","markdown":"/zh-hans/3.2/ref/paginator.md","json":"/zh-hans/3.2/ref/paginator.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/ref/paginator.txt","official":"https://docs.djangoproject.com/zh-hans/3.2/ref/paginator/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}