djangodocs

Django 6.0
Gaeilge
Documentation contents

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:

    Code
    path("objects/page<int: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' </topics/pagination>.

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í

**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ó. <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 `.

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.

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í

**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)

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

View as Markdown Edit this page on GitHub Official version