Django filter_horizontal|极客笔记

Django filter_horizontal

在Django中，filter_horizontal是一个ModelAdmin类的属性，用于在Admin站点中为多对多关系字段提供一个水平选择框。这使得用户能够在一个更容易管理的水平选择框中选择关联的对象，而不是在一个垂直选择框中。

用法

要在Admin中使用filter_horizontal，首先需要在你的ModelAdmin类中定义该属性。例如，假设我们有一个博客应用，其中有一篇文章可以有多个标签，我们想在Admin中使用filter_horizontal来管理这些标签。我们可以像下面这样定义ModelAdmin类：

from django.contrib import admin
from .models import Article

class ArticleAdmin(admin.ModelAdmin):
    filter_horizontal = ('tags',)

admin.site.register(Article, ArticleAdmin)

在这个示例中，我们在ArticleAdmin类中定义了filter_horizontal属性，并指定了要水平显示的关联字段，即tags字段。这样，在Article的编辑页面中，我们将看到一个水平选择框，可以在其中选择相关的标签。

配置

有时候，在使用filter_horizontal时，我们可能需要对它进行一些配置，比如指定水平选择框的宽度。filter_horizontal默认使用宽度为300px的水平选择框，但我们可以通过覆盖django.contrib.admin.widgets.RelatedFieldWidgetWrapper来进行自定义。

from django.contrib.admin.options import widgets

class CustomHorizontalFilterWidget(widgets.RelatedFieldWidgetWrapper):
    def __init__(self, widget, model, admin_site, *args, **kwargs):
        super().__init__(widget, model, admin_site, *args, **kwargs)
        self.widget.attrs['style'] = 'width: 500px;'

class ArticleAdmin(admin.ModelAdmin):
    filter_horizontal = ('tags',)
    formfield_overrides = {
        models.ManyToManyField: {'widget': CustomHorizontalFilterWidget},
    }

admin.site.register(Article, ArticleAdmin)

在上述代码中，我们定义了CustomHorizontalFilterWidget类，继承自django.contrib.admin.widgets.RelatedFieldWidgetWrapper，通过覆盖init方法来设置水平选择框的宽度为500px。然后我们在ArticleAdmin类中使用formfield_overrides来应用这个自定义的Widget。