Django 自定义 Django admin ChangeForm 模板 / 添加自定义内容

在本文中，我们将介绍如何自定义 Django 后台管理系统（admin）的 ChangeForm 模板，并添加自定义内容。Django 的 admin 后台管理系统提供了强大的功能，但有时我们可能需要根据自己的需求对其进行定制化。

阅读更多：Django 教程

了解 Django admin ChangeForm 模板

在开始自定义之前，让我们先了解一下 Django admin 的 ChangeForm模板。ChangeForm 模板负责展示单个对象的编辑页面，其中包含了对象的各个字段和相应的输入控件。

Django admin 使用自己的模板引擎，称为 django-template，它使用特殊的语法标签来表示动态内容。ChangeForm 模板使用以下标签：

• {% block content %}...{% endblock %}：用于定义主要内容区域；
• {% block field_sets %}...{% endblock %}：用于定义字段集合；
• {% block form_top %}...{% endblock %}：用于定义表单顶部的内容；
• {% block form_bottom %}...{% endblock %}：用于定义表单底部的内容。

可以通过对这些 block 区域的重写来自定义 ChangeForm 模板。

自定义 ChangeForm 模板

首先，我们需要创建一个自定义的 ChangeForm 模板。在你的应用的 templates 目录下创建一个 “admin” 文件夹，并在其中创建一个名为 “your_model_change_form.html” 的文件（注意将 “your_model” 替换为你想要自定义的模型的名称）。

{% extends 'admin/change_form.html' %}

{% block content %}
    <!-- 添加你的自定义内容 -->
{% endblock %}

{% block field_sets %}
    <!-- 自定义字段集合的样式和内容 -->
{% endblock %}

{% block form_top %}
    <!-- 添加你希望在表单顶部显示的内容 -->
{% endblock %}

{% block form_bottom %}
    <!-- 添加你希望在表单底部显示的内容 -->
{% endblock %}

在这个自定义模板中，我们继承了默认的 ChangeForm 模板，并在相应的 block 区域中添加了自定义内容。你可以根据具体需求在不同的 block 区域添加自定义的 HTML、CSS 和 JavaScript 代码。

接下来，我们需要告诉 Django 使用这个自定义模板。在你的应用的 admin.py 文件中，找到需要自定义的模型的 admin 类，并将其 change_form_template 属性设置为你刚创建的自定义模板路径。例如：

from django.contrib import admin

from .models import YourModel

class YourModelAdmin(admin.ModelAdmin):
    change_form_template = 'admin/your_model_change_form.html'

admin.site.register(YourModel, YourModelAdmin)

这样，当你在后台管理系统中编辑该模型的对象时，将会使用你自定义的 ChangeForm 模板。

添加自定义内容

在自定义的 ChangeForm 模板中，你可以方便地添加自定义的内容，如文本、链接、按钮等。以下是几个示例：

• 添加文本内容：

{% block content %}
    <p>这是一些自定义内容。</p>
{% endblock %}

• 添加链接：

{% block form_top %}
    <a href="/your-link/">点击这里</a>查看更多相关信息。
{% endblock %}

• 添加按钮：

{% block form_bottom %}
    <button type="button" class="btn">提交</button>
{% endblock %}

你可以根据需要在相应的 block 区域中添加更多的自定义内容，使得编辑页面更符合你的需求。

总结

通过自定义 Django admin 的 ChangeForm 模板，我们可以根据自己的需求对后台管理系统进行定制化。通过重写模板的 block 区域，我们可以添加自定义内容，使得编辑页面更加个性化。希望本文对你理解和使用 Django 的 admin 后台管理系统有所帮助。