如何在Django Admin面板展示Requirement关联的图片与文档字段？

要实现Requirement模型和关联的RequirementImage、RequirementDoc在Admin面板中一同展示，只需通过Django Admin的Inline功能即可完成，具体步骤如下：

1. 定义Inline类 #

在你的admin.py文件中，为RequirementImage和RequirementDoc创建对应的Inline类，这样就能在Requirement的编辑/详情页面嵌入关联的图片和文档表单：

from django.contrib import admin
from .models import Requirement, RequirementImage, RequirementDoc

# 图片关联Inline（表格式展示）
class RequirementImageInline(admin.TabularInline):
    model = RequirementImage
    extra = 1  # 默认显示1个新增图片的空白表单
    # 若需设置只读字段，可添加readonly_fields = ['id']

# 文档关联Inline（表格式展示）
class RequirementDocInline(admin.TabularInline):
    model = RequirementDoc
    extra = 1

如果更喜欢堆叠式的展示样式，可将TabularInline替换为StackedInline。

2. 配置Requirement的Admin类 #

将上面定义的Inline类注册到RequirementAdmin中，同时配置列表页和详情页的展示字段：

@admin.register(Requirement)
class RequirementAdmin(admin.ModelAdmin):
    # 列表页展示的核心字段
    list_display = ('name', 'city', 'created_at', 'get_image_count', 'get_doc_count')
    # 详情页字段分组（可选，让页面结构更清晰）
    fieldsets = (
        ('基本信息', {
            'fields': ('name', 'description', 'mobile', 'email', 'city')
        }),
        ('时间记录', {
            'fields': ('created_at', 'updated_at'),
            'classes': ('collapse',)  # 设置为可折叠分组
        })
    )
    # 关联嵌入的Inline组件
    inlines = [RequirementImageInline, RequirementDocInline]
    # 自动生成的时间字段设为只读
    readonly_fields = ('created_at', 'updated_at')

    # 自定义方法：在列表页显示关联图片的数量
    def get_image_count(self, obj):
        return obj.requirementimage_set.count()
    get_image_count.short_description = '图片数量'

    # 自定义方法：在列表页显示关联文档的数量
    def get_doc_count(self, obj):
        return obj.requirementdoc_set.count()
    get_doc_count.short_description = '文档数量'

3. 优化关联内容的展示（可选） #

如果希望在详情页直接预览图片或快速下载文档，可给Inline类添加自定义只读字段：

图片预览功能 #

修改RequirementImageInline，添加图片缩略图预览：

class RequirementImageInline(admin.TabularInline):
    model = RequirementImage
    extra = 1
    readonly_fields = ('image_preview',)

    def image_preview(self, obj):
        if obj.image:
            return f'<img src="{obj.image.url}" width="100" height="100" />'
        return '无图片'
    image_preview.short_description = '图片预览'

文档下载链接 #

修改RequirementDocInline，添加文档直接下载的链接：

class RequirementDocInline(admin.TabularInline):
    model = RequirementDoc
    extra = 1
    readonly_fields = ('doc_download',)

    def doc_download(self, obj):
        if obj.requirement_file:
            return f'<a href="{obj.requirement_file.url}" target="_blank">下载文档</a>'
        return '无文档'
    doc_download.short_description = '文档操作'

效果说明 #

完成配置后：

• 在Requirement的列表页，会显示每条需求的基本信息，以及关联的图片、文档数量；
• 在Requirement的编辑/详情页，页面下方会直接展示关联的图片和文档表单，可直接完成新增、删除、修改操作，同时能预览图片或点击下载文档。

内容的提问来源于stack exchange，提问作者Smith