自定义选项卡中的Django admin StackedInline

基础概念

Django Admin 是 Django 框架中的一个内置应用，用于提供一个用户友好的界面来管理数据库中的数据。StackedInline 是 Django Admin 中的一个类，用于在同一个页面中嵌入相关模型的编辑表单。

类型与应用场景

类型

StackedInline：垂直堆叠的表单，适合字段较少的模型。
TabularInline：表格形式的表单，适合字段较多且需要展示多个实例的场景。

应用场景

一对多关系：当一个模型有多个相关联的子模型时，使用 StackedInline 可以方便地进行批量编辑。
嵌套表单：需要在编辑主模型时，同时编辑其关联的子模型。

示例代码

假设我们有两个模型 Author 和 Book，其中 Author 和 Book 是一对多的关系：

# models.py
from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)

在 admin.py 中配置 StackedInline：

# admin.py
from django.contrib import admin
from .models import Author, Book

class BookInline(admin.StackedInline):
    model = Book
    extra = 1  # 默认显示一个额外的空表单

class AuthorAdmin(admin.ModelAdmin):
    inlines = [BookInline]

admin.site.register(Author, AuthorAdmin)

遇到的问题及解决方法

问题1：StackedInline 表单不显示

原因：可能是由于模型字段未正确导入或配置错误。

解决方法：确保模型字段正确导入，并且在 StackedInline 中正确指定了模型。

from .models import Author, Book

class BookInline(admin.StackedInline):
    model = Book
    extra = 1

问题2：StackedInline 表单过多导致页面加载缓慢

原因：当关联的子模型实例非常多时，页面加载会变慢。

解决方法：

使用 extra 参数控制默认显示的空表单数量。
考虑使用 TabularInline 替代 StackedInline，因为表格形式更适合展示多个实例。

class BookInline(admin.TabularInline):
    model = Book
    extra = 5

问题3：StackedInline 表单中的字段验证失败

原因：可能是由于字段验证规则设置不当或数据不一致。

解决方法：

检查模型字段的验证规则，确保其符合预期。
在 StackedInline 中添加自定义的验证逻辑。

from django.core.exceptions import ValidationError

class BookInline(admin.StackedInline):
    model = Book
    extra = 1

    def clean(self):
        super().clean()
        # 自定义验证逻辑
        for form in self.forms:
            if form.cleaned_data.get('title') == '':
                raise ValidationError("Title cannot be empty.")

通过以上方法，可以有效解决在使用 Django Admin 的 StackedInline 时遇到的常见问题。