--- title: "Meascáin réad iolracha" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/ref/class-based-views/mixins-multiple-object/ canonical: https://djangodocs.dev/ga/6.0/ref/class-based-views/mixins-multiple-object/ --- # Meascáin réad iolracha ## `MultipleObjectMixin` #### `class django.views.generic.list.MultipleObjectMixin` Meascán is féidir a úsáid chun liosta rudaí a thaispeáint. 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: - Úsáid an paraiméadar `leathanach` sa URLConf. Mar shampla, seo an chuma a d'fhéadfadh a bheith ar do URLConf: ``` path("objects/page/", PaginatedView.as_view()), ``` - Pas uimhir an leathanaigh tríd an bparaiméadar sreangán fiosrúcháin leathanach\`. Mar shampla, bheadh cuma seo ar URL: ```text /objects/?page=3 ``` 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`. Le haghaidh tuilleadh eolais faoi leathanaigh, léigh an:doc: doiciméadú leathanacha' \. Mar chás speisialta, ceadaítear duit `deireann` a úsáid mar luach do leathanach\`: ```text /objects/?page=last ``` 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. 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\`. **Síneadaí** - [`django.views.generic.base.ContextMixin`](/ga/6.0/ref/class-based-views/mixins-simple/#django.views.generic.base.ContextMixin) Modhanna agus Gnéithe \*\* #### `allow_empty` 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`. #### `model` An tsamhail a thaispeánfaidh an dearcadh seo sonraí dó. \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 . #### `queryset` `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. > **Warning** > > Is tréith aicme é `queryset` le luach\*athraithe\* agus mar sin caithfear cúram a thabhairt nuair a úsáidtear é go díreach. Sula n-úsáidtear é, glaoigh aith:meth: ~django.db.models.query.queryset.all modh nó faigh é le: meth: get\_queryset a thugann aire don chlónáil taobh thiar de na radhairc. #### `ordering` 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. #### `paginate_by` 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. #### `paginate_orphans` 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. #### `page_kwarg` 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`. #### `paginator_class` 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. #### `context_object_name` Ainmníonn sé ainm an athróg le húsáid sa chomhthéacs. #### `get_queryset()` 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). #### `get_ordering()` Tugann sreang ar ais (nó teaghráin in-athraithe) a shainmhíníonn an t-ordú a chuirfear i bhfeidhm ar an `Queryset`. Tuairisceáin: attr: ordú de réir réamhshocraithe. #### `paginate_queryset(queryset, page_size)` Tugann sé 4 thipple ar ais ina bhfuil (`paginator`, leathanach\`, liosta\_object\`, `is_paginated`). 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. #### `get_paginate_by(queryset)` 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. #### `get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True)` 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. #### `get_paginate_orphans()` 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. #### `get_allow_empty()` 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`. #### `get_context_object_name(object_list)` 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`. #### `get_context_data(**kwargs)` Tugann sonraí comhthéacs ar ais chun liosta rudaí a thaispeáint. **Comhthéacs** - `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`. - `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. - `paginator`: Sampla de:class: django.core.paginator.paginator. Mura bhfuil an leathanach leathanaigh, is é an athróg comhthéacs seo ná `None`. - `page_obj`: Sampla de:class: django.core.paginator.page. Mura bhfuil an leathanach leathanaigh, is é an athróg comhthéacs seo ná `None`. ## `MultipleObjectTemplateResponseMixin` #### `class django.views.generic.list.MultipleObjectTemplateResponseMixin` 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. **Síneadaí** - [`TemplateResponseMixin`](/ga/6.0/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin) Modhanna agus Gnéithe \*\* #### `template_name_suffix` An iarmhír le cur leis an ainm teimpléid iarrthóra a ghintear go huathoibríoch. Is é `_list` iarmhír réamhshocraithe. #### `get_template_names()` Tugann liosta ainmneacha teimpléad iarrthóra ar ais. Tugann an liosta seo a leanas ar ais: - luach `template_name` ar an radharc (má chuirtear ar fáil) - \\\`\`\/.html\`\`