ModelAdmin 列表过滤器Link to this heading#ModelAdmin 类可以定义出现在管理员的更改列表页面右侧边栏上的列表过滤器，如下面的截图所示：
![\"/zh-hans/5.1/_images/list_filter.png\"](\"/zh-hans/5.1/_images/list_filter.png\")
\n要启用按字段过滤，将 ModelAdmin.list_filter 设置为一个元素列表或元组，其中每个元素都是以下类型之一：
一个字段名称。
django.contrib.admin.SimpleListFilter 的子类。
一个包含字段名称和 django.contrib.admin.FieldListFilter 子类的 2 元组。
请查看以下示例，讨论了定义 list_filter 的每个选项。
最简单的选项是指定你的模型中需要的字段名称。
\n每个指定的字段应该是 BooleanField、CharField、DateField、DateTimeField、IntegerField、ForeignKey 或 ManyToManyField 中的一个，例如：
class PersonAdmin(admin.ModelAdmin):\n list_filter = ["is_staff", "company"]\nlist_filter 中的字段名也可以使用 __ 查找来跨越关系，例如：
class PersonAdmin(admin.UserAdmin):\n list_filter = ["company__name"]\nSimpleListFilterLink to this heading#对于自定义过滤，你可以通过子类化 django.contrib.admin.SimpleListFilter 来定义自己的列表过滤器。你需要提供 title 和 parameter_name 属性，并重写 lookups 和 queryset 方法，例如：
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#最后，如果你希望为一个字段指定明确的过滤器类型，你可以提供一个包含 2 个元素的 list_filter 项，其中第一个元素是字段名称，第二个元素是继承自 django.contrib.admin.FieldListFilter 的类，例如：
class PersonAdmin(admin.ModelAdmin):\n list_filter = [\n ("is_staff", admin.BooleanFieldListFilter),\n ]\n这里"is_staff"字段将使用"BooleanFieldListFilter"。在大多数情况下，只指定字段名的字段会自动使用适当的过滤器，但这种格式允许您控制所使用的过滤器。
\n下面的示例显示了您需要选择使用的可用过滤器类别。
\n你可以使用 RelatedOnlyFieldListFilter 将相关模型的选择限制在该关系所涉及的对象上：
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("author", admin.RelatedOnlyFieldListFilter),\n ]\n假设 author 是一个指向 User 模型的 ForeignKey，这将限制 list_filter 的选择只列出写过书的用户，而不是列出所有用户。
你可以使用 EmptyFieldListFilter 来过滤空值，它既可以过滤空字符串也可以过滤空值，这取决于字段允许存储的内容：
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("title", admin.EmptyFieldListFilter),\n ]\n通过使用 __in 查询，可以过滤一组值中的任何一个。你需要重写 expected_parameters 方法，并指定具有适当字段名称的 lookup_kwargs 属性。默认情况下，查询字符串中的多个值将用逗号分隔，但可以通过 list_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]\n列表过滤器通常只在过滤器具有多个选择时才会出现。过滤器的 has_output() 方法控制它是否出现。
可以指定一个自定义模板来呈现列表过滤器：
\nclass FilterWithCustomTemplate(admin.SimpleListFilter):\n template = "custom_template.html"\n具体的例子请看 Django 提供的默认模板（admin/filter.html）。
默认情况下，可以通过在管理界面上切换打开来显示每个筛选器的计数，称为 facets。这些计数将根据当前应用的筛选器而更新。有关更多详细信息，请参阅 ModelAdmin.show_facets。