Soláthraíonn Django cúpla rang a chuidíonn leat sonraí leathanaigh a bhainistiú - is é sin, sonraí atá roinnte ar fud roinnt leathanaigh, le naisc “Roimhe Sea/Ar Aghaidh”. Tá na ranganna seo ina gcónaí in:source: django/core/paginator.py.
\nLe haghaidh samplaí, féach an:doc: `Treoir ábhair leathanacha' </topics/pagination>.
\nPaginatorLink to this heading#Feidhmíonn leathanaigh cosúil le seicheamh de:class: Leathanach nuair a úsáidtear `len () ``nó é ag athrá go díreach.
\nRiachtanach. Liosta, tuple, QuerySet, nó réad eile atá inslithe le modh count () ``nó ``__len__ (). Le haghaidh leathanaigh chomhsheasmhach, ba cheart QuerySets a ordú, m.sh. le an:meth: ~django.db.models.query.queryset.order_by clásal nó le clásal réamhshocraithe:attr: ~Django.db.Models.Options.Ordering ar an tsamhail.
Riachtanach. An líon uasta na míreanna atá le cur san áireamh ar leathanach, gan dílleachtaí san áireamh (féach an argóint roghnach: attr: ~Paginator.orphans thíos).
\nOptional. Use this when you don't want to have a last page with very few\nitems. If the last page would normally have a number of items less than or\nequal to orphans, then those items will be added to the previous page\n(which becomes the last page) instead of leaving the items on a page by\nthemselves. For example, with 23 items, per_page=10, and orphans=3,\nthere will be two pages; the first page with 10 items and the second\n(and last) page with 13 items. orphans defaults to zero, which means\npages are never combined and the last page may have one item. orphans\nshould be less than the per_page value.
Optional. Whether or not the first page is allowed to be empty. If\nFalse and object_list is empty, then an EmptyPage error will\nbe raised.
Ligeann an argóint error_messages duit na teachtaireachtaí réamhshocraithe a ardóidh an paginator a shárú. Pas isteach i bhfoclóir le heochracha a mheaitseálann leis na teachtaireachtaí earráide is mian leat a shárú. Is iad na heochracha teachtaireachta earráide atá ar fáil ná: invalid_page, min_page`, agus no_results.
Mar shampla, seo an teachtaireacht earráide réamhshocraithe:
\n>>> from django.core.paginator import Paginator\n>>> paginator = Paginator([1, 2, 3], 2)\n>>> paginator.page(5)\nTraceback (most recent call last):\n ...\nEmptyPage: That page contains no results\nAgus seo teachtaireacht earráide saincheaptha:
\n>>> paginator = Paginator(\n... [1, 2, 3],\n... 2,\n... error_messages={"no_results": "Page does not exist"},\n... )\n>>> paginator.page(5)\nTraceback (most recent call last):\n ...\nEmptyPage: Page does not exist\nTuairisceáin a: aicme: réad Leathanach leis an t-innéacs bunaithe ar 1 a thugtar, agus uimhreacha leathanaigh lasmuigh de raon agus neamhbhailí a láim
\nMura bhfuil an leathanach ina uimhir, filleann sé an chéad leathanach ar ais. Má tá uimhir an leathanaigh diúltach nó níos mó ná líon na leathanaigh, filleann sé an leathanach deireanach ar ais.
\nArdaíonn eisceacht an:exc: EmptyPage ach má shonraíonn tú Paginator (..., allow_empty_first_page=False) ``agus tá an `object_list folamh.
Tuairisceáin a: aicme: réad Leathanach leis an innéacs 1-bhunaithe a thugtar. Ardaithe:exc: PageNotanInteger mura féidir an uimhre a thiontú go sláimhir trí ``int () ``a ghlaoch. Ardaithe:exc: EmptyPage mura bhfuil an uimhir leathanaigh a thugtar ann.
Tugann liosta 1-bhunaithe ar ais d'uimhreacha leathanaigh cosúil la:attr: Paginator.page_range, ach féadfaidh sé ellipsis a chur le ceachtar nó ar an dá thaobh den uimhir leathanaigh reatha nuai:attr: Paginator.num_pages mór.
\nCinntear líon na leathanaigh atá le cur san áireamh ar gach taobh den uimhir leathanaigh reatha ag an argóint on_each_side atá réamhshocraithe go 3.
Cinntear líon na leathanaigh atá le cur san áireamh ag tús agus ag deireadh raon leathanaigh ag an argóint on_ends` atá réamhshocraithe go 2.
\nMar shampla, leis na luachanna réamhshocraithe do on_each_side agus on_ends, má tá an leathanach reatha 10 agus má tá 50 leathanach ann, beidh raon an leathanaigh [1, 2, '...', 7, 8, 9, 10, 11, 12, 13, '...', 49, 50]. Mar thoradh air seo beidh leathanaigh 7, 8, agus 9 ar thaobh na láimhe clé de agus 11, 12, agus 13 ar dheis den leathanach reatha chomh maith le leathanaigh 1 agus 2 ag an tús agus 49 agus 50 ag an deireadh.
Ardaithe:exc: Invalidpage mura bhfuil an uimhir leathanaigh thugtar ann.
\nSreang inaistrithe a úsáidtear mar ionad d'uimhreacha leathanaigh éilithe sa raon leathanaigh ar ais ag: meth: ~paginator.get_elided_page_range. Is é réamhshocraithe '... '.
Líon iomlán na rudaí, ar fud na leathanaigh go léir.
\n\nLíon iomlán na leathanaigh.
\nAthraitheoir raon 1-bhunaithe d'uimhreacha leathanaigh, m.sh. ag toradh [1, 2, 3, 4].
AsyncPaginator classLink to this heading#Asynchronous version of Paginator.
AsyncPaginator has the same attributes and signatures as\nPaginator, with the following exceptions:
The attribute Paginator.count is supported as an asynchronous\nmethod AsyncPaginator.acount().
The attribute Paginator.num_pages is supported as an\nasynchronous method AsyncPaginator.anum_pages().
The attribute Paginator.page_range is supported as an\nasynchronous method AsyncPaginator.apage_range().
AsyncPaginator has asynchronous versions of the same methods as\nPaginator, using an a prefix - for example, use\nawait async_paginator.aget_page(number) rather than\npaginator.get_page(number).
LeathanachLink to this heading#De ghnáth ní thógfaidh tú rudaí Page de láimh - gheobhaidh tú iad trí:class: Paginator a athrá, nó trí:meth: Paginator.page a úsáid.
Feidhmíonn leathanach cosúil le seicheamh de:attr: Page.Object_List nuair a úsáidtear `len () ``nó ag athrá go díreach é.
\nTugann sé ar ais True má tá an chéad leathanach eile ann.
Tugann sé ar ais True má tá leathanach roimhe seo ann.
Tugann sé ar ais True má tá an chéad leathanach eile **nó ** roimhe seo ann.
Tugann an chéad uimhir leathanaigh eile ar ais. Ardaithe:exc: Invalidpage mura bhfuil an chéad leathanach eile ann.
\nTugann uimhir leathanaigh roimhe seo ar ais. Ardaithe:exc: InvalidPage mura bhfuil an leathanach roimhe seo ann.
\nFilleann sé innéacs 1-bhunaithe an chéad réad ar an leathanach, i gcoibhneas leis na rudaí go léir i liosta an paginéora. Mar shampla, nuair a bheidh liosta de 5 rud á ndéanamh leathanaigh le 2 rud in aghaidh an leathanaigh, chuirfeadh an dara leathanach's:meth: ~page.start_index ar ais 3.
Filleann sé an t-innéacs 1-bhunaithe den réad deireanach ar an leathanach, i gcoibhneas leis na rudaí go léir i liosta an leathanaigh. Mar shampla, nuair a chuirtear liosta de 5 rud le 2 rud in aghaidh an leathanaigh á leathanaigh á leathanaigh, chuirfeadh an dara leathanach's:meth: ~page.end_index ar ais 4.
An liosta na rudaí ar an leathanach seo.
\nAn uimhir leathanaigh 1-bhunaithe don leathanach seo.
\nAn réad comhcheangail:class: Paginator.
\nAsyncPage classLink to this heading#Asynchronous version of Page.
AsyncPage has the same attributes and signatures as Page, as\nwell as asynchronous versions of all the same methods, using an a\nprefix - for example, use await async_page.ahas_next() rather than\npage.has_next().
AsyncPage has the following additional method:
Returns AsyncPage.object_list as a list. This method must be\nawaited before AsyncPage can be treated as a sequence of\nAsyncPage.object_list.
Aicme bonn le haghaidh eisceachtaí a ardaítear nuair a chuirtear uimhir leathanaigh neamhbhailí ar phaginator.
\nArdaíonn an modh: Meth: Paginator.page eisceacht mura bhfuil an leathanach iarrtha neamhbhailí (ie nach sláimhir) nó nach bhfuil aon rudaí ann. Go ginearálta, is leor an eisceacht Invalidpage a ghabháil, ach más mian leat níos mó gráinneachta, is féidir leat ceachtar de na heisceachtaí seo a leanas a ghabháil:
Ardaítear nuai:meth: ~Paginator.page tugtar luach nach sláimhir é.
\nArdaítear nuai:meth: ~Paginator.page tugtar luach bailí ach níl aon rud ann ar an leathanach sin.
\nIs fo-aicmí iad an dá eisceacht de:exc: InvalidPage, ionas gur féidir leat iad a láimhseáil le ach amháin InvalidPage.