Django Admin 自定义list_display|极客教程

Django Admin 自定义list_display

在使用Django开发Web应用时，我们可以通过Django Admin来管理后台数据。Django Admin是一个功能强大的自动生成后台管理界面的工具，我们可以通过它来对数据库的增删改查操作。

在Django Admin中，默认情况下会显示Model中定义的字段，但有时候我们需要自定义显示哪些字段，这时就可以使用list_display来自定义显示字段。

什么是list_display

list_display是Django Admin中用于定义显示哪些字段的属性，我们可以在Admin类中设置list_display属性来显示我们想要展示的字段。默认情况下，list_display是一个元组，其中包含了要显示的字段名称。

如何自定义list_display

我们可以在Admin类中设置list_display属性，来自定义显示哪些字段。下面我们以一个示例来演示如何自定义list_display。

假设我们有一个应用名为blog，其中有一个Model名为Post，该Model定义如下：

# models.py
from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=50)
    content = models.TextField()
    publish_date = models.DateTimeField()

接下来我们需要在Admin中自定义list_display，来显示title、author和publish_date字段。我们可以在Admin类中设置list_display属性来实现。

# admin.py
from django.contrib import admin
from .models import Post

class PostAdmin(admin.ModelAdmin):
    list_display = ('title', 'author', 'publish_date')

admin.site.register(Post, PostAdmin)

通过以上设置，我们在Django Admin中就可以看到title、author和publish_date字段的内容。

定制显示字段

除了显示Model中定义的字段外，我们还可以在list_display中显示一些自定义字段。比如我们想要显示文章内容的前50个字符，在Admin中处理这种显示逻辑是非常方便的。

# admin.py
class PostAdmin(admin.ModelAdmin):
    list_display = ('title', 'author', 'publish_date', 'short_content')

    def short_content(self, obj):
        return obj.content[:50]

    short_content.short_description = 'Content'

admin.site.register(Post, PostAdmin)

在上面的代码中，我们定义了一个名为short_content的方法，并将其设置为list_display中的一个字段。在该方法中，我们截取了content字段的前50个字符作为显示内容。

定制显示方法

除了显示字段外，我们还可以显示Model中的方法。假设我们有一个Model如下：

# models.py
class Book(models.Model):
    title = models.CharField(max_length=100)

    def get_author_name(self):
        return f'Author: {self.author}'

如果我们想要在Django Admin中显示Book中的get_author_name方法，可以通过list_display来实现。

# admin.py
class BookAdmin(admin.ModelAdmin):
    list_display = ('title', 'get_author_name')

    def get_author_name(self, obj):
        return obj.get_author_name()

    get_author_name.short_description = 'Author Name'

admin.site.register(Book, BookAdmin)

在上面的代码中，我们将Book中的get_author_name方法设置为list_display中的一个字段，并通过自定义方法来实现显示逻辑。