ModelAdmin リストフィルタLink to this heading#ModelAdmin クラスは、以下のスクリーンショットのように、admin アプリケーションの変更一覧ページの右サイドバーに表示されるリストフィルタを定義できます:
![\"/ja/5.0/_images/list_filter.png\"](\"/ja/5.0/_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"]\nSimpleListFilter を使用するLink 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]\nFieldListFilter を使用するLink to this heading#最後に、フィールドに使用する明示的なフィルタタイプを指定したい場合は、2値タプルとして list_filter 項目を指定できます。最初の要素はフィールド名で、2番目の要素は django.contrib.admin.FieldListFilter を継承したクラスです。例:
class PersonAdmin(admin.ModelAdmin):\n list_filter = [\n ("is_staff", admin.BooleanFieldListFilter),\n ]\nここでは is_staff フィールドは BooleanFieldListFilter を使用します。ほとんどの場合、フィールド名を指定するだけでフィールドは自動的に適切なフィルタを使用しますが、この形式では使用するフィルタを制御できます。
以下の例は、使用するためにオプトインする必要がある利用可能なフィルタクラスを示します。
\nリレーション先モデルの選択肢を、そのリレーションに含まれるオブジェクトに限定できます。これには RelatedOnlyFieldListFilter を使用します:
class BookAdmin(admin.ModelAdmin):\n list_filter = [\n ("author", admin.RelatedOnlyFieldListFilter),\n ]\nauthor が User モデルの ForeignKey であるとすると、これは list_filter の選択肢を、すべてのユーザーではなく、本を書いたユーザーに制限します。
空の値は EmptyFieldListFilter を使ってフィルタリングできます。これは、フィールドが何を保存できるかに応じて、空の文字列と NULL の両方をフィルタリングできます:
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) を参照してください。
デフォルトでは、ファセット (facet) と呼ばれる各フィルタのカウントは、admin UIからトグルで表示できます。これらのカウントは現在適用されているフィルタに応じて更新されます。詳細は ModelAdmin.show_facets を参照してください。