Django admin列表页添加自定义按钮|极客教程

Django admin列表页添加自定义按钮

Django是一个开放源代码的Web应用程序框架，用于快速开发Web应用程序。其中包含了一个强大的后台管理系统，即Django admin。Django admin提供了一个方便的界面，让开发人员可以轻松管理和维护数据。

在Django admin的列表页中，通常会显示一些操作按钮，如“新增”，“编辑”和“删除”。但有时候我们需要添加一些自定义的按钮，以实现一些特殊的功能。本文将详细介绍如何在Django admin的列表页中添加自定义按钮。

步骤1：创建一个admin action

要在Django admin的列表页中添加自定义按钮，首先需要创建一个admin action。admin action是一种可以在多个对象上执行的操作。我们可以定义一个函数，然后将其注册为admin action。以下是一个简单的示例：

from django.contrib import admin
from .models import MyModel

def custom_action(modeladmin, request, queryset):
    for obj in queryset:
        # do something with obj
        pass

@admin.register(MyModel)
class MyModelAdmin(admin.ModelAdmin):
    actions = [custom_action]

在上面的示例中，我们定义了一个名为custom_action的函数，然后将其注册为MyModelAdmin的action。当用户在MyModel的列表页上选择多个对象后，就可以点击“Actions”下拉框中的“Custom action”按钮来执行custom_action函数。

步骤2：自定义按钮的显示文本

虽然我们已经成功创建了一个admin action，但默认情况下它会显示为“Custom action”这样的文本。如果我们想要显示一个更友好和具体的文本，可以通过自定义short_description属性来实现。例如：

custom_action.short_description = "Custom Action"

步骤3：在模板中添加自定义按钮

虽然我们已经创建了自定义的admin action，并给它指定了显示文本，但这只是在后台实现了自定义功能。要在列表页上显示一个按钮，需要在相应的模板文件中添加一些代码。

在Django的模板语言中，我们可以通过重写base_site.html文件来自定义admin的模板。我们可以在这个文件中添加一些HTML代码，用于显示我们的自定义按钮。以下是一个简单的示例：

{% extends "admin/base_site.html" %}
{% block extrastyle %}
<style>
    .custom-button {
        color: #fff;
        background-color: #007bff;
        padding: 5px 10px;
        border-radius: 5px;
        text-decoration: none;
    }
</style>
{% endblock %}

{% block content %}
<div id="content" class="flex">
    <div id="content-main">
        <div class="submit-row">
            <a href="{% url 'admin:app_model_custom_action' %}" class="custom-button">Custom Action</a>
        </div>
        {{ block.super }}
    </div>
</div>
{% endblock %}

在上面的示例中，我们定义了一个样式为.custom-button的按钮，并使用Django的{% url %}模板标签来生成自定义按钮的链接。当用户点击这个按钮时，就会执行我们之前定义的custom_action函数。