Django admin list_display属性用法

在本文中，我们将介绍Django admin的list_display属性的用法。list_display是Django admin中一个非常有用的属性，它允许开发人员自定义在admin后台管理界面中显示的字段。

简介

Django admin是Django框架自带的一个强大的后台管理界面，在数据库数据的增删改查等操作中，提供了方便的界面来进行管理。在admin界面中，我们通常会显示一些字段来展示模型的信息，list_display属性就是用来指定要在admin界面上显示的字段。

使用方法

使用list_display属性非常简单。我们只需要在自定义的模型管理类中添加一个list_display的属性，该属性的值为一个由模型字段组成的列表。这些字段将会以表格的形式展示在admin界面上。

下面是一个示例：

from django.contrib import admin
from .models import Book

class BookAdmin(admin.ModelAdmin):
    list_display = ['title', 'author', 'publication_date']

admin.site.register(Book, BookAdmin)

在这个示例中，我们定义了一个BookAdmin的模型管理类，并在其中添加了list_display属性，指定了要在admin界面上展示的字段为title、author和publication_date。当我们在admin界面中查看Book模型的数据时，这三个字段将会以表格的形式显示出来。

高级用法

除了简单地指定模型字段，list_display属性还支持一些高级用法，来满足更复杂的显示需求。

使用模型方法

我们可以在list_display属性中使用模型的方法。方法应该没有参数，并返回一个字符串作为该字段的显示内容。

以下是一个示例：

from django.contrib import admin
from .models import Product

class ProductAdmin(admin.ModelAdmin):
    list_display = ['name', 'price', 'formatted_price']

    def formatted_price(self, obj):
        return f'${obj.price}'

admin.site.register(Product, ProductAdmin)

在这个示例中，我们定义了一个formatted_price方法来格式化价格字段。在list_display属性中，我们将formatted_price方法也加入了显示字段列表。这样，在admin界面中，除了显示正常的name和price字段，还会显示经过格式化的价格字段。

使用属性装饰器

Django还提供了一个便捷的装饰器@admin.display，可以用来将一个方法转换为属性，从而使其可以在list_display属性中使用。这个装饰器的作用相当于定义了一个只读属性。

以下是一个示例：

from django.contrib import admin
from .models import Order

class OrderAdmin(admin.ModelAdmin):
    list_display = ['order_number', 'total_price']

    @admin.display(description='Total Price')
    def total_price(self, obj):
        return obj.calculate_total_price()

admin.site.register(Order, OrderAdmin)

在这个示例中，我们使用@admin.display装饰器将total_price方法转换为了一个只读属性。在list_display属性中，我们将这个属性也加入了显示字段列表。注意，我们还可以通过description参数来指定该字段在admin界面上的显示名称。