Django 如何为 Django StackedInline 添加 ‘collapse’

在本文中，我们将介绍如何为 Django StackedInline 添加 ‘collapse’ 功能。Django StackedInline 是 Django Admin 中的一种内联表单，它允许我们在同一个页面上编辑多个相关联的模型。

阅读更多：Django 教程

什么是 Django StackedInline

Django StackedInline 是 Django Admin 中一种常用的内联表单，它可以在同一个页面上编辑多个相关联的模型。例如，在一个订单管理系统中，我们可能需要在订单页面上同时编辑订单的商品明细。而 Django StackedInline 就提供了一种简单的方式来实现这个功能。

如何使用 Django StackedInline

要在 Django 中使用 StackedInline，我们需要在 admin.py 文件中定义一个内联类，然后将它作为参数传递给父模型的注册方法。下面是一个示例：

from django.contrib import admin
from .models import Order, OrderItem

class OrderItemInline(admin.StackedInline):
    model = OrderItem

class OrderAdmin(admin.ModelAdmin):
    inlines = [
        OrderItemInline,
    ]

admin.site.register(Order, OrderAdmin)

在上面的示例中，我们定义了一个 OrderItemInline 类作为 Order 模型的内联表单。然后，在 OrderAdmin 类中将内联表单作为一个列表传递给 inlines 属性。最后，我们使用 admin.site.register 方法将 Order 模型和 OrderAdmin 类进行注册。

为 Django StackedInline 添加 ‘collapse’

默认情况下，Django StackedInline 中的所有字段都是可见的。但在有些情况下，我们可能希望将一些字段隐藏起来，只在需要时显示。这时，我们可以使用 Django Admin 提供的一个 CSS 类 ‘collapse’ 来实现。

要为 Django StackedInline 添加 ‘collapse’ 功能，我们可以通过自定义 Admin 模板来实现。下面是一个示例：

from django.contrib import admin
from django.forms.models import BaseInlineFormSet
from .models import Order, OrderItem

class OrderItemInline(admin.StackedInline):
    model = OrderItem
    template = 'admin/collapsible_stacked.html'
    collapse_toggle = True

class OrderAdmin(admin.ModelAdmin):
    inlines = [
        OrderItemInline,
    ]

admin.site.register(Order, OrderAdmin)

在上面的示例中，我们定义了一个 OrderItemInline 类，并将 template 属性设置为自定义的模板文件路径 ‘admin/collapsible_stacked.html’。我们还设置了 collapse_toggle 属性为 True，以启用 ‘collapse’ 功能。

然后，我们创建一个名为 ‘admin/collapsible_stacked.html’ 的模板文件。下面是一个示例：

{% extends 'admin/edit_inline/stacked.html' %}

{% block inline_container %}{{ formset.management_form }}
    <fieldset class="module {% if collapse_toggle %}collapsed{% endif %}">
        <h2 class="collapsible {% if collapse_toggle %}collapsed{% endif %}">
            {{ inline_admin_formset.opts.verbose_name_plural|capfirst }}
        </h2>
        <div class="form-row {% if collapse_toggle %}collapsed{% endif %}">
            {{ inline_admin_formset.formset.management_form }}
            {% for form in inline_admin_formset.forms %}
                {{ form }}
            {% endfor %}
        </div>
    </fieldset>
{% endblock %}

在上面的模板文件中，我们继承了 Django Admin 默认的 stacked.html 模板，然后在 inline_container 块中对模板进行自定义。我们在 <fieldset> 元素上添加了一个名为 ‘collapsed’ 的 CSS 类，以实现初始状态下折叠的效果。同时，我们在 <h2> 元素和 <div> 元素上也添加了名为 ‘collapsed’ 的 CSS 类，以实现点击折叠/展开操作。

总结

通过本文的介绍，我们学习了如何为 Django StackedInline 添加 ‘collapse’ 功能。首先，我们了解了 Django StackedInline 的基本概念和使用方法。然后，我们学习了如何通过自定义 Admin 模板来实现 ‘collapse’ 功能。希望本文对你理解和使用 Django StackedInline 以及为其添加 ‘collapse’ 功能有所帮助。