Django Admin 后台模型列表页面如何添加自定义操作按钮

小林子

发布时间：2026-10-14 | 4人浏览过

原创

本文介绍如何在 Django Admin 的模型列表页面添加自定义批量操作按钮，而非使用默认的操作下拉菜单。通过重写 get_urls 方法定义视图，并扩展 admin/change_list.html 模板添加表单按钮，实现如“所有英雄死亡”或“所有英雄永生”等批量状态更新功能。

Django Admin 添加自定义批量操作按钮教程

为了实现批量管理功能，我们需要在 Django Admin 后台添加两个独立的按钮：一个用于将所有英雄状态设为死亡，另一个用于将所有英雄设为永生。由于这些操作作用于所有记录且与用户选择无关，因此它们不应包含在常规的操作下拉菜单中，而应作为独立的按钮存在。

首先，我们需要修改 HeroAdmin 管理模型所引用的模板文件，以便在界面中嵌入这两个自定义按钮。


@admin.register(Hero)
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin):
  change_list_template = "entities/heroes_changelist.html"

接下来，我们需要重写 get_urls 方法，并在管理模型中定义 set_immortal 和 set_mortal 两个视图函数。这两个函数将分别处理“永生”和“凡人”状态的批量更新逻辑。


def get_urls(self):
  urls = super().get_urls()
  my_urls = [
    path('immortal/', self.set_immortal),
    path('mortal/', self.set_mortal),
  ]
  return my_urls + urls
def set_immortal(self, request):
  self.model.objects.all().update(is_immortal=True)
  self.message_user(request, "All heroes are now immortal")
  return HttpResponseRedirect("../")
def set_mortal(self, request):
  self.model.objects.all().update(is_immortal=False)
  self.message_user(request, "All heroes are now mortal")
  return HttpResponseRedirect("../")

最后，通过继承 admin/change_list.html 模板来创建自定义的 changelist 模板文件 entities/heroes_changelist.html，用于渲染上述按钮。


{% extends 'admin/change_list.html' %}
{% block object-tools %}
  <div>
    <form action="immortal/" method="POST">
      {% csrf_token %}
        <button type="submit">Make Immortal</button>
    </form>
    <form action="mortal/" method="POST">
      {% csrf_token %}
        <button type="submit">Make Mortal</button>
    </form>
  </div>
  <br />
  {{ block.super }}
{% endblock %}