Meascáin réad aonairLink to this heading

SingleObjectMixinLink to this heading

class django.views.generic.detail.SingleObjectMixinLink to this definition

Soláthraíonn sé meicníocht chun réad a bhaineann leis an iarratas reatha HTTP a chuardach.

**Modhanna agus Gnéithe **

modelLink to this definition

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

querysetLink to this definition

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.

slug_fieldLink to this definition

Ainm an réimse ar an tsamhail ina bhfuil an slug. De réir réamhshocraithe, is é slug_field `slug'.

slug_url_kwargLink to this definition

Ainm an argóint eochairfhocal URLConf ina bhfuil an slug. De réir réamhshocraithe, is é slug_url_kwarg `slug'.

pk_url_kwargLink to this definition

Ainm an argóint eochairfhocal URLConf ina bhfuil an príomh-eochair. De réir réamhshocraithe, is é pk_url_kwarg `pk'.

context_object_nameLink to this definition

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

query_pk_and_slugLink to this definition

Má tá True, is cúis le: meth: get_object () `a chuardach a dhéanamh ag baint úsáide as an bpríomh-eochair agus an slug araon. Réamhshocraithe go ``False`.

Is féidir leis an tréith seo cabhrú le hionsaithe tagairt réad díreach neamhchinnti a mhaolú. Nuair a cheadaíonn feidhmchláir rochtain ar rudaí aonair trí phríomh-eochair seicheamhach, d'fhéadfadh ionsaitheoir gach URL a thuairim a dhéanamh; ar an gcaoi sin liosta de na rudaí go léir san fheidhmchlár a fháil. Má cheart cosc a chur ar úsáideoirí a bhfuil rochtain acu ar rudaí aonair an liosta seo a fháil, cuideoidh socrú query_pk_and_slug go True` le tuairim URLanna a chosc mar beidh dhá argóint cheart neamh-seicheamhach ag teastáil ó gach URL. D'fhéadfadh go mbeadh an cuspóir céanna ag baint úsáide as slug uathúil, ach tugann an scéim seo deis duit slugs neamh-uathúla a bheith agat.

get_object(queryset=None)Link to this definition

Filleann sé an réad aonair a thaispeánfaidh an radharc seo. Má chuirtear queryset ar fáil, úsáidfear an tacar ceisteanna sin mar fhoinse na rudaí; ar shlí eile, úsáidfear :meth: get_queryset. Féachann ``get_object () ``argóint a: attr: pk_url_kwarg sna hargóintí leis an dearcadh; má aimsítear an argóint seo, déanann an modh seo cuardach bunaithe ar eochair bhunaithe ag baint úsáide as an luach sin. Mura bhfaightear an argóint seo, féachann sé argóint a:attr: slug_url_kwarg, agus déanann sé cuardach slug ag baint úsáide as an: attr: slug_field.

Nuair: attr: query_pk_and_slug True, déanfaidh ``get_object () ``a chuardach ag baint úsáide as an eochair phríomhúil agus an slug araon.

get_queryset()Link to this definition

Filleann sé an tacar fiosrúcháin a úsáidfear chun an réad a thaispeánfaidh an dearcadh seo a aisghabháil. De réir réamhshocraithe, filleann :meth: get_queryset luach an tréithe: attr: queryset má tá sé socraithe, ar shlí eile tógann sé a:class: ~django.db.models.query.queryset trí ghlaoch ar an modh ``all () ``ar bhainisteoir réamhshocraithe tréith: model.

get_context_object_name(obj)Link to this definition

Tabhair ar ais ainm athróg an chomhthéacs a úsáidfear chun na sonraí atá á ionramháil ag an dearcadh seo a áireamh. Má tá: attr: context_object_name socraithe, déanfar an t-ainm comhthéacs a thógáil ó model_name den tsamhail a bhfuil an tacar ceisteanna comhdhéanta as. Mar shampla, bheadh réad comhthéacs darb ainm `Airteag sa tsamhail Airteagal.

get_context_data(**kwargs)Link to this definition

Filleann sonraí comhthéacs chun an réad a thaispeáint

Éilíonn cur i bhfeidhm bonn an mhodha seo go socraítear an tréith self.object ag an radharc (fiú mura bhfuil None). Bí cinnte é seo a dhéanamh má tá an meascán seo á úsáid agat gan ceann de na tuairimí ionsuite a dhéanann amhlaidh.

Tugann sé foclóir ar ais leis na hábhair seo:

  • object: An réad atá ag taispeáint an dearcadh seo (self.object).

  • Stórálfar context_object_name: self.object faoin ainm ar ais ag: meth: get_context_object_name, a réamhshocraíonn an leagan íseal den ainm samhail.

get_slug_field()Link to this definition

Tugann ainm réimse slug ar ais le húsáid chun breathnú suas le slug. De réir réamhshocraithe filleann sé luach: attr: slug_field.

SingleObjectTemplateResponseMixinLink to this heading

class django.views.generic.detail.SingleObjectTemplateResponseMixinLink to this definition

Aicme meascáin a dhéanann rindreáil freagartha bunaithe ar theimpléad do thuairimí a oibríonn ar shampla réad amháin. Éilíonn sé go soláthraíonn an dearcadh a bhfuil sé measctha leis self.object ``, an sampla réada a bhfuil an radharc ag feidhmiú air. Is gnách go mbeidh `self.object ``mar shampla Django, ach cheanglaítear é a bheith ann. D'fhéadfadh a bheith ``None má tá an dearcadh i bpróiseas chun cás nua a thógáil.

Síneadaí

**Modhanna agus Gnéithe **

template_name_fieldLink to this definition

An réimse ar an gcás réad reatha is féidir a úsáid chun ainm teimpléad iarrthóra a chinneadh. Más é template_name_field féin nó luach an template_name_field ar an gcás réad reatha None, ní úsáidfear an réad le haghaidh ainm teimpléad iarrthóra.

template_name_suffixLink to this definition

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

get_template_names()Link to this definition

Returns a list of candidate template names. Return a list containing template_name, if set on the value. Otherwise, return a list containing:

  • ábhar an réimse template_name_field ar an gcás réad a bhfuil an radharc ag feidhmiú air (má tá sé ar fáil)

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