ModelAdmin Scagairí LiostaLink to this heading#Is féidir le ranganna ModelAdmin scagairí liosta a shainiú atá le feiceáil i mbarra taobh na láimhe deise de leathanach liosta athraithe an riaracháin, mar a léirítear sa scáileán seo a leanas:
![\"/ga/6.1/_images/list_filter.png\"](\"/ga/6.1/_images/list_filter.png\")
\nChun scagadh in aghaidh an réimse a ghníomhachtú, socraí:attr: ModelAdmin.list_filter chuig liosta nó tupla eilimintí, áit a bhfuil gach eilimint ar cheann de na cineálacha seo a leanas:
\nAinm réimse.
Fo-aicme de Django.Contrib.admin.SimpleListFilter.
2 tuple ina bhfuil ainm réimse agus fo-aicme de Django.Contrib.admin.FieldListFilter.
Féach na samplaí thíos chun plé a dhéanamh ar gach ceann de na roghanna seo chun list_filter` a shainiú.
\nIs é an rogha is simplí ná na hainmneacha réimse riachtanacha a shonrú ó do shamhail.
\nBa chóir go mbeadh Booleanfield, Charfield`, DateField, DateTimeField`, Integerfield, ForeignKey` nó ManyTomanyField, ManyToManyField, mar shampla:
class PersonAdmin(admin.ModelAdmin):\n list_filter = ["is_staff", "company"]\nIs féidir le hainmneacha réimse i list_filter` caidrimh a scaipeadh freisin ag baint úsáide as an lorg __, mar shampla:
class PersonAdmin(admin.UserAdmin):\n list_filter = ["company__name"]\nSimpleListFilterLink to this heading#Le haghaidh scagadh saincheaptha, is féidir leat do scagaire liosta féin a shainiú trí “Django.Contrib.Admin.SimpleListFilter” a fho-aicmiú. Ní mór duit na tréithe `title agus parameter_name a sholáthar, agus na modhanna lookups agus queryset a shárú, m.sh.:
from datetime import date\n\nfrom django.contrib import admin\nfrom django.utils.translation import gettext_lazy as _\n\n\nclass DecadeBornListFilter(admin.SimpleListFilter):\n # Human-readable title which will be displayed in the\n # right admin sidebar just above the filter options.\n title = _("decade born")\n\n # Parameter for the filter that will be used in the URL query.\n parameter_name = "decade"\n\n def lookups(self, request, model_admin):\n """\n Returns a list of tuples. The first element in each\n tuple is the coded value for the option that will\n appear in the URL query. The second element is the\n human-readable name for the option that will appear\n in the right sidebar.\n """\n return [\n ("80s", _("in the eighties")),\n ("90s", _("in the nineties")),\n ]\n\n def queryset(self, request, queryset):\n """\n Returns the filtered queryset based on the value\n provided in the query string and retrievable via\n `self.value()`.\n """\n # Compare the requested value (either '80s' or '90s')\n # to decide how to filter the queryset.\n if self.value() == "80s":\n return queryset.filter(\n birthday__gte=date(1980, 1, 1),\n birthday__lte=date(1989, 12, 31),\n )\n if self.value() == "90s":\n return queryset.filter(\n birthday__gte=date(1990, 1, 1),\n birthday__lte=date(1999, 12, 31),\n )\n\n\nclass PersonAdmin(admin.ModelAdmin):\n list_filter = [DecadeBornListFilter]\nFieldlistFilter follasachLink to this heading#Mar fhocal scoir, más mian leat cineál scagaire follasach a shonrú le húsáid le réimse féadfaidh tú mír list_filter` a sholáthar mar 2-tuple, áit a bhfuil ainm réimse an chéad eilimint agus is aicme é an dara eilimint ag oidhreacht ó django.contrib.admin.fieldlistfilter, mar shampla:
class PersonAdmin(admin.ModelAdmin):\n list_filter = [\n ("is_staff", admin.BooleanFieldListFilter),\n ]\nAnseo úsáidfidh an réimse is_staff an BooleanFieldListFilter`. Ag sonrú ach ainm an réimse, úsáidfidh réimsí an scagaire cuí go huathoibríoch don chuid is mó de na cásanna, ach tugann an fhormáid seo deis duit an scagaire a úsáidtear
Taispeánann na samplaí seo a leanas ranganna scagaire atá ar fáil a chaithfidh tú roghnú isteach le húsáid.
\nFéadfaidh tú roghanna samhail ghaolmhara a theorannú leis na rudaí a bhaineann leis an ngaol sin ag baint úsáide as RelatedOnlyFieldListFilter:
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("author", admin.RelatedOnlyFieldListFilter),\n ]\nAg glacadh leis gur ForeignKey é údar` do mhúnla Úsáideora ``, cuirfidh sé seo teorainn leis na roghanna ``list_filter do na húsáideoirí a scríobh leabhar, in ionad gach úsáideoir a liostáil.
Is féidir leat luachanna folmha a scagadh ag baint úsáide as EmptyFieldListFilter`, atá in ann scagadh ar theagáin folamh agus ar neamhaill araon, ag brath ar an méid a cheadaíonn an réimse a stóráil:
\nclass BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("title", admin.EmptyFieldListFilter),\n ]\nBy defining a filter using the __in lookup, it is possible to filter for\nany of a group of values. You need to override the expected_parameters\nmethod, and then specify the lookup_kwargs attribute with the appropriate\nfield name. By default, multiple values in the query string will be separated\nwith commas, but this can be customized via the list_separator attribute.\nThe following example shows such a filter using the vertical-pipe character as\nthe separator:
class FilterWithCustomSeparator(admin.FieldListFilter):\n # custom list separator that should be used to separate values.\n list_separator = "|"\n\n def __init__(self, field, request, params, model, model_admin, field_path):\n self.lookup_kwarg = "%s__in" % field_path\n super().__init__(field, request, params, model, model_admin, field_path)\n\n def expected_parameters(self):\n return [self.lookup_kwarg]\nDe ghnáth ní bhfeictear scagairí liosta ach amháin má tá níos mó ná rogha amháin ag an scagaire. Rialaíonn modh ``has_output () ``scagaire cibé an bhfuil sé le feiceáil nó nach bhfuil.
\nIs féidir teimpléad saincheaptha a shonrú chun scagaire liosta a rindreáil:
\nclass FilterWithCustomTemplate(admin.SimpleListFilter):\n template = "custom_template.html"\nFéach an teimpléad réamhshocraithe a sholáthraíonn Django (admin/filter.html) le haghaidh sampla nithiúil.
De réir réamhshocraithe, is féidir comhaireamh do gach scagaire, ar a dtugtar gnéithe, a thaispeáint trí aistriú tríd an gChomhéadan riaracháin. Déanfar na comhaireanta seo a nuashonrú de réir na scagairí atá i bhfeidh Féach: attr: ModelAdmin.show_facets le haghaidh tuilleadh sonraí.
\n