{"title":"Meascáin réad iolracha","version":"5.2","locale":"ga","docname":"ref/class-based-views/mixins-multiple-object","url":"/ga/5.2/ref/class-based-views/mixins-multiple-object/","canonical":"https://djangodocs.dev/ga/5.2/ref/class-based-views/mixins-multiple-object/","summary":"MultipleObjectMixin Link to this heading # class django.views.generic.list. MultipleObjectMixin Link to this definition # Meascán is féidir a úsáid chun liosta…","html":"

Meascáin réad iolrachaLink to this heading#

\n
\n

MultipleObjectMixinLink to this heading#

\n
\n
\nclass django.views.generic.list.MultipleObjectMixinLink to this definition#
\n

Meascán is féidir a úsáid chun liosta rudaí a thaispeáint.

\n

Má shonraítear paginate_by, déanfaidh Django na torthaí a chuirtear ar ais leis seo a leathnú. Is féidir leat uimhir an leathanaigh sa URL a shonrú ar cheann de dhá bhealach:

\n
    \n

  • Úsáid an paraiméadar leathanach sa URLConf. Mar shampla, seo an chuma a d'fhéadfadh a bheith ar do URLConf:

    \n
    Code
    path("objects/page<int:page>/", PaginatedView.as_view()),\n
    \n
    • \n

  • Pas uimhir an leathanaigh tríd an bparaiméadar sreangán fiosrúcháin ``leathanach`. Mar shampla, bheadh cuma seo ar URL:

    \n
    Text
    /objects/?page=3\n
    \n
    • \n
\n

Tá na luachanna agus na liostaí seo bunaithe ar 1, ní bunaithe ar 0, mar sin léiríodh an chéad leathanach mar leathanach 1.

\n

Le haghaidh tuilleadh eolais faoi leathanaigh, léigh an:doc: `doiciméadú leathanacha' </topics/pagination>.

\n

Mar chás speisialta, ceadaítear duit deireann a úsáid mar luach do leathanach`:

\n
Text
/objects/?page=last\n
\n

Ligeann sé seo duit rochtain a fháil ar leathanach deiridh na dtorthaí gan a chinneadh ar dtús cé mhéad leathanach atá ann.

\n

Tabhair faoi deara go gcaithfidh leathanach *uimhir leathanaigh bailí nó an luach deireana; beidh earráid 404 mar thoradh ar aon luach eile le haghaidh leathanach`.

\n

Síneadaí

\n\n

**Modhanna agus Gnéithe **

\n
\n
\nallow_emptyLink to this definition#
\n

Boolean a shonraíonn an bhfuil an leathanach le taispeáint mura bhfuil aon rudaí ar fáil. Más é seo False agus mura bhfuil aon rudaí ar fáil, ardóidh an radharc 404 in ionad leathanach folamh a thaispeáint. De réir réamhshocraithe, is é seo True.

\n
\n\n
\n
\nmodelLink to this definition#
\n

An tsamhail a thaispeánfaidh an dearcadh seo sonraí dó. <default-managers>Tá model = Foo' a shonrú go héifeachtach mar an gcéanna le ``queryset = foo.objects.all () ``a shonrú, áit a sheasann` objects`` do `foo': ref: `bainisteoir réamhshocraithe `.

\n
\n\n
\n
\nquerysetLink to this definition#
\n

QuerySet a léiríonn na rudaí. Má chuirtear ar fáil, cuireann luach ``fiosrúchán ``in ionad an luach a sholáthraítear le haghaidh: attr: samhail.

\n\n
\n\n
\n
\norderingLink to this definition#
\n

Sreang nó liosta teaghráin a shonraíonn an t-ordú a chuirfear i bhfeidhm ar an Queryset. Tá luachanna bailí mar an gcéanna leo siúd le haghaidh: meth: ~django.db.models.query.queryset.order_by.

\n
\n\n
\n
\npaginate_byLink to this definition#
\n

Sláimhir a shonraíonn cé mhéad réad ba chóir a thaispeáint in aghaidh Má thugtar é seo, leathnóidh an dearcadh rudaí le rudaí paginate_by in aghaidh an leathanaigh. Beidh an dearcadh ag súil le paraiméadar teaghrán fiosrúcháin page (trí request.get`) nó athróg page a shonraítear sa URLConf.

\n
\n\n
\n
\npaginate_orphansLink to this definition#
\n

Sláimhir a shonraíonn líon na rudaí “ró-shreabhadh” is féidir leis an leathanach deireanach a bheith. Leathnaíonn sé seo an teorainne:attr: paginate_by ar an leathanach deireanach suas go paginate_orphans, d'fhonn an leathanach deireanach a choinneáil ó líon an-bheag rudaí a bheith aige.

\n
\n\n
\n
\npage_kwargLink to this definition#
\n

Sreang a shonraíonn an t-ainm atá le húsáid do pharaiméadar an leathanaigh. Beidh an dearcadh ag súil go mbeidh an paraiméadar seo ar fáil mar pharaiméadar teaghrán fiosrúcháin (trí request.get) nó mar athróg kwarg a shonraítear sa URLConf. Réamhshocraithe go leathanach.

\n
\n\n
\n
\npaginator_classLink to this definition#
\n

An rang paginator le húsáid le haghaidh leathanaigh. De réir réamhshocraithe, úsáidtear: class: django.core.paginator.paginator. Mura bhfuil an comhéadan tógála céanna ag an rang paginator saincheaptha las:class: django.core.paginator.paginator, beidh ort cur i bhfeidhm a sholáthar dó:meth: get_paginator freisin.

\n
\n\n
\n
\ncontext_object_nameLink to this definition#
\n

Ainmníonn sé ainm an athróg le húsáid sa chomhthéacs.

\n
\n\n
\n
\nget_queryset()Link to this definition#
\n

Faigh liosta na míreanna don radharc seo. Caithfidh sé seo a bheith ina athrá agus d'fhéadfadh sé a bheith ina tacar ceisteanna (ina gcumasófar iompar sonrach le fiosrúcháin).

\n
\n\n
\n
\nget_ordering()Link to this definition#
\n

Tugann sreang ar ais (nó teaghráin in-athraithe) a shainmhíníonn an t-ordú a chuirfear i bhfeidhm ar an Queryset.

\n

Tuairisceáin: attr: `ordú `de réir réamhshocraithe.

\n
\n\n
\n
\npaginate_queryset(queryset, page_size)Link to this definition#
\n

Tugann sé 4 thipple ar ais ina bhfuil (paginator, leathanach`, liosta_object`, is_paginated).

\n

Tógtha trí leathanach queryset a chur isteach i leathanaigh de mhéid page_size. Má tá argóint leathanach san iarraidh, mar argóint URL gabháilte nó mar argóint GET, comhfhreagróidh object_list do na rudaí ón leathanach sin.

\n
\n\n
\n
\nget_paginate_by(queryset)Link to this definition#
\n

Tugann sé ar ais líon na míreanna atá le leathiniú ag, nó None gan aon leathanach. De réir réamhshocraithe filleann sé seo an luach de:attr: paginate_by.

\n
\n\n
\n
\nget_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True)Link to this definition#
\n

Tugann sé sampla den paginator ar ais le húsáid don radharc seo. De réir réamhshocraithe, cruthaíonn sé sampla de:attr: paginator_class.

\n
\n\n
\n
\nget_paginate_orphans()Link to this definition#
\n

Sláimhir a shonraíonn líon na rudaí “ró-shreabhadh” is féidir leis an leathanach deireanach a bheith. De réir réamhshocraithe filleann sé luach: attr: paginate_orphans.

\n
\n\n
\n
\nget_allow_empty()Link to this definition#
\n

Tabhair boolean ar ais ag sonrú an bhfuil an leathanach le taispeáint mura bhfuil aon rudaí ar fáil. Má fhilleann an modh seo False agus nach bhfuil aon rudaí ar fáil, ardóidh an radharc 404 in ionad leathanach folamh a thaispeáint. De réir réamhshocraithe, is é seo True.

\n
\n\n
\n
\nget_context_object_name(object_list)Link to this definition#
\n

Tabhair ar ais ainm an athróg comhthéacs a úsáidfear chun liosta na sonraí atá ag ionramháil leis an dearcadh seo a bheith ann. Más tacar ceisteanna de rudaí Django é object_list agus mura socraítear: attr: context_object_name, is é an t-ainm comhthéacs model_name den tsamhail a bhfuil an tacar ceisteanna comhdhéanta as, le postfix '_list' curtha leis. Mar shampla, bheadh réad comhthéacs darb ainm article_list ag an tsamhail Airteagal.

\n
\n\n
\n
\nget_context_data(**kwargs)Link to this definition#
\n

Tugann sonraí comhthéacs ar ais chun liosta rudaí a thaispeáint.

\n
\n\n

Comhthéacs

\n
    \n

  • object_list: An liosta rudaí atá ag taispeáint an dearcadh seo. Má shonraítear context_object_name, socraítear an t-athróg sin sa chomhthéacs freisin, leis an luach céanna le object_list.

    • \n

  • is_paginated: Boolean a léiríonn cibé an bhfuil na torthaí leathanaigh. Go sonrach, tá sé seo socraithe go False mura sonraíodh aon mhéid leathanaigh, nó mura bhfuil na rudaí atá ar fáil réimse ar iliomad leathanaigh.

    • \n

  • paginator: Sampla de:class: django.core.paginator.paginator. Mura bhfuil an leathanach leathanaigh, is é an athróg comhthéacs seo ná None.

    • \n

  • page_obj: Sampla de:class: django.core.paginator.page. Mura bhfuil an leathanach leathanaigh, is é an athróg comhthéacs seo ná None.

    • \n
\n
\n\n
\n
\n

MultipleObjectTemplateResponseMixinLink to this heading#

\n
\n
\nclass django.views.generic.list.MultipleObjectTemplateResponseMixinLink to this definition#
\n

Aicme meascáin a dhéanann rindreáil freagartha bunaithe ar theimpléad do thuairimí a oibríonn ar liosta cásanna réada. Éilíonn go soláthraíonn an dearcadh a bhfuil sé measctha leis self.object_list, liosta na gcásanna réada a bhfuil an dearcadh ag feidhmiú orthu. D'fhéadfadh go mbeadh self.object_list, ach ní cheanglaítear a bheith, a:class: ~django.db.models.query.queryset.

\n

Síneadaí

\n\n

**Modhanna agus Gnéithe **

\n
\n
\ntemplate_name_suffixLink to this definition#
\n

An iarmhír le cur leis an ainm teimpléid iarrthóra a ghintear go huathoibríoch. Is é _list iarmhír réamhshocraithe.

\n
\n\n
\n
\nget_template_names()Link to this definition#
\n

Tugann liosta ainmneacha teimpléad iarrthóra ar ais. Tugann an liosta seo a leanas ar ais:

\n
    \n

  • luach template_name ar an radharc (má chuirtear ar fáil)

    • \n

  • <model_name><template_name_suffix>``<app_label>/.html``

    • \n
\n
\n\n
\n\n
","rootId":"multiple-object-mixins","toc":[{"title":"MultipleObjectMixin","anchor":"multipleobjectmixin","children":[]},{"title":"MultipleObjectTemplateResponseMixin","anchor":"multipleobjecttemplateresponsemixin","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/class-based-views/index","title":"API tuairimí rang-bhunaithe ionsuite","url":"/ga/5.2/ref/class-based-views/"},{"docname":"ref/class-based-views/mixins","title":"Meascáin tuairimí rang-bhunaithe","url":"/ga/5.2/ref/class-based-views/mixins/"}],"prev":{"docname":"ref/class-based-views/mixins-single-object","title":"Meascáin réad aonair","url":"/ga/5.2/ref/class-based-views/mixins-single-object/"},"next":{"docname":"ref/class-based-views/mixins-editing","title":"Eagarthóireacht meascáin","url":"/ga/5.2/ref/class-based-views/mixins-editing/"},"formats":{"html":"/ga/5.2/ref/class-based-views/mixins-multiple-object/","markdown":"/ga/5.2/ref/class-based-views/mixins-multiple-object.md","json":"/ga/5.2/ref/class-based-views/mixins-multiple-object.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/class-based-views/mixins-multiple-object.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/class-based-views/mixins-multiple-object/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}