ModelAdmin Lista FilterLink to this heading#klasserna ModelAdmin kan definiera listfilter som visas i det högra sidofältet på sidan med ändringslistan i admin, vilket illustreras i följande skärmdump:
![\"/sv/5.2/_images/list_filter.png\"](\"/sv/5.2/_images/list_filter.png\")
\nFör att aktivera filtrering per fält anger du ModelAdmin.list_filter till en lista eller en tupel av element, där varje element är en av följande typer:
Ett fältnamn.
En underklass av django.contrib.admin.SimpleListFilter.
En 2-tupel som innehåller ett fältnamn och en subklass av django.contrib.admin.FieldListFilter.
Se exemplen nedan för en diskussion om vart och ett av dessa alternativ för att definiera list_filter.
Det enklaste alternativet är att ange de obligatoriska fältnamnen från din modell.
\nVarje angivet fält ska vara antingen en BooleanField, CharField, DateField, DateTimeField, IntegerField, ForeignKey eller ManyToManyField, till exempel:
class PersonAdmin(admin.ModelAdmin):\n list_filter = ["is_staff", "company"]\nFältnamn i list_filter kan också spänna över relationer med hjälp av __ lookup, till exempel:
class PersonAdmin(admin.UserAdmin):\n list_filter = ["company__name"]\nSimpleListFilterLink to this heading#För anpassad filtrering kan du definiera ditt eget listfilter genom att underklassa django.contrib.admin.SimpleListFilter. Du måste tillhandahålla attributen title och parameter_name och åsidosätta metoderna lookups och queryset, t.ex.:
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]\nFieldListFilterLink to this heading#Slutligen, om du vill ange en explicit filtertyp som ska användas med ett fält kan du tillhandahålla ett list_filter-objekt som en 2-tupel, där det första elementet är ett fältnamn och det andra elementet är en klass som ärver från django.contrib.admin.FieldListFilter, till exempel:
class PersonAdmin(admin.ModelAdmin):\n list_filter = [\n ("is_staff", admin.BooleanFieldListFilter),\n ]\nHär kommer fältet is_staff att använda filtret BooleanFieldListFilter. Om du bara anger fältnamnet kommer fälten automatiskt att använda lämpligt filter i de flesta fall, men med det här formatet kan du styra vilket filter som används.
Följande exempel visar tillgängliga filterklasser som du måste anmäla dig för att använda.
\nDu kan begränsa valen i en relaterad modell till de objekt som är involverade i den relationen med hjälp av RelatedOnlyFieldListFilter:
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("author", admin.RelatedOnlyFieldListFilter),\n ]\nOm man antar att author är en ForeignKey till en User-modell, kommer detta att begränsa list_filter-valen till de användare som har skrivit en bok, istället för att lista alla användare.
Du kan filtrera tomma värden med hjälp av EmptyFieldListFilter, som kan filtrera på både tomma strängar och nollor, beroende på vad fältet tillåter att lagra:
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("title", admin.EmptyFieldListFilter),\n ]\nGenom att definiera ett filter med hjälp av __in lookup, är det möjligt att filtrera för något av en grupp av värden. Du måste åsidosätta metoden expected_parameters och ange attributet lookup_kwargs med lämpligt fältnamn. Som standard kommer flera värden i frågesträngen att separeras med kommatecken, men detta kan anpassas via attributet list_separator. Följande exempel visar ett sådant filter som använder tecknet vertikalt rör som 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]\nListfilter visas vanligtvis bara om filtret har mer än ett val. Ett filters has_output()-metod styr om det ska visas eller inte.
Det är möjligt att ange en anpassad mall för rendering av ett listfilter:
\nclass FilterWithCustomTemplate(admin.SimpleListFilter):\n template = "custom_template.html"\nSe standardmallen som tillhandahålls av Django (admin/filter.html) för ett konkret exempel.
Som standard kan räkningar för varje filter, så kallade facetter, visas genom att slå på dem via admingränssnittet. Dessa räkningar uppdateras i enlighet med de filter som används för närvarande. Se ModelAdmin.show_facets för mer information.