Django定制Admin页面详细实例(展示页面和编辑页面)

更新时间：2023年06月25日 09:49:42 作者：顽固油渍

django自带的admin因为功能和样式比较简陋,常常需要再次定制,下面这篇文章主要给大家介绍了关于Django定制Admin页面(展示页面和编辑页面)的相关资料,需要的朋友可以参考下

以上篇文章中注册的Goods应用为例

默认的Admin系统中，Goods应用的详情页

上图中，并未显示商品的具体信息（名称等），统一名称为 Goods Object，为方便项目操作和管理，可在文件 model.py 中添加如下代码，用来显示商品名称和 id 信息：

def __str__(self):
    return '%s:%s' % (self.id, self.name)

效果如下（可通过点击进入商品详情页面）：

如需定制此页面的展示信息，可以在文件 admin.py 中使用以下关键字达到预期效果：

1. list_display选项：用于控制页面展示的字段，该选项的值为元组或列表类型，其中的元素可以是模型字段或自定义字段

2. list_display_links选项：用于设置需在页面中以链接形式展示的字段,可跳转到详情页面

# 计算销售额的函数
def sales_volume(g):
    total = g.price * g.sales
    return f'{g.name}销售额为:{total}'
sales_volume.short_description = '商品销售额' # 设置字段描述
 
# 装饰器方法注册应用
@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    list_display_links = ('id', 'name',)  # 设置字段链接

显示效果（蓝色字段点击可进入商品详情页）：

3. list_filter选项：用于开启列表页过滤器，该选项可以接收模型中的字段作为过滤条件

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time')
    # list_filter = ['name',]  # 过滤器

效果如下（即为通过特定条件筛选目标）：

4. list_per_page选项：用于设置每页显示的数据量

5. list_editable选项用于设置可编辑的字段，字段若被指定为编辑字段，页面上可直接编辑该字段。

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    list_display_links = ('id', 'name',)  # 设置字段链接
    list_filter = ['id', 'name']  # 过滤器
    list_per_page = 5     # 每页展示5条记录
    list_editable = ('price', 'stock')  # 设置商品价格和库存为可编辑字段

显示效果如下：

5. search_fields选项：用于配置搜索字段

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time')
    list_display_links = ('id', 'name',)  # 设置字段链接
    list_filter = ['id', 'name']  # 过滤器
    list_per_page = 5     # 每页展示5条记录
    list_editable = ('price', 'stock')  # 设置商品价格和库存为可编辑字段
    search_fields = ('name',)   # 表示以 name 作为搜索字段

显示效果：

7. actions_on_top选项：用于设置是否在顶部显示动作下拉框，默认为True，表示在顶部显示。

8. actions_on_bottom选项：用于设置管理员动作是否在底部显示，默认为False，表示不在底部显示，当设置为True表示在底部显示。

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    # actions_on_top选项用于设置是否在顶部显示动作下拉框
    # actions_on_bottom选项用于设置管理员动作是否在底部显示
    actions_on_top = False
    actions_on_bottom = True

显示效果：

定制商品详情页面（即编辑页面），依然是在admin.py文件中，有如下选项：

1. fields选项：用于控制编辑页要显示的字段，它的值是元组类

fields选项支持以二维元组形式设置字段分栏显示，在fileds中一个元组表示一栏数据

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin): 
    fields = ('name', 'price', 'stock')

显示效果：

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fields = (('name', 'price'), ('stock', 'sales'))      # 分栏显示

效果如下：

2. fieldsets选项：用于对可编辑字段进行分组，该选项不可与fields选项同时使用

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )

效果如下：

3. readonly_fields选项：用于设置只读字段

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )
    readonly_fields = ('name',)

效果如下：

4. save_on_top选项：用于社会是否在编辑页上方显示保存、删除等按钮，默认为False

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )
    readonly_fields = ('name',)
    save_on_top = True

效果如下：

总结

到此这篇关于Django定制Admin页面的文章就介绍到这了,更多相关Django定制Admin页面内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python多线程与多进程相关知识总结
进程(process)和线程(thread)是操作系统的基本概念,是操作系统程序运行的基本单元,本文简要介绍进程和线程的概念以及Python中的多进程和多线程.需要的朋友可以参考下
2021-05-05
Python socket实现的简单通信功能示例
这篇文章主要介绍了Python socket实现的简单通信功能,结合实例形式分析了Python socket通信的相关概念、原理、客户端与服务器端实现技巧以及socketserver模块多并发简单实现方法,需要的朋友可以参考下
2018-08-08
pandas or sql计算前后两行数据间的增值方法
下面小编就为大家分享一篇pandas or sql计算前后两行数据间的增值方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-04-04
Python如何绘制概率分布直方图浅析
项目中在前期经常要看下数据的分布情况,这对于探究数据规律非常有用,概率分布表示样本数据的模样,使用Python绘制频率分布直方图非常简洁,因为用的频次非常高,这篇文章主要给大家介绍了关于Python如何绘制概率分布直方图的相关资料,需要的朋友可以参考下
2021-12-12
用Python把csv文件批量修改编码为UTF-8格式并转为Excel格式的方法
有时候用excel打开一个csv文件,中文全部显示乱码,然后手动用notepad++打开,修改编码为utf-8并保存后,再用excel打开显示正常,本文将给大家介绍一下用Python把csv文件批量修改编码为UTF-8格式并转为Excel格式的方法,需要的朋友可以参考下
2023-09-09
python的Tqdm模块的使用
这篇文章主要介绍了python的Tqdm模块的使用，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-01-01
基于Python和TFIDF实现提取文本中的关键词
TFIDF 的工作原理是按比例增加一个词语在文档中出现的次数，但会被它所在的文档数量抵消。本文将利用TFIDF实现提取文本中的关键词，感兴趣的小伙伴快跟随小编一起学习一下吧
2022-04-04
ubuntu中配置pyqt4环境教程
本文给大家分享的是在Ubuntu系统中配置pyqt4的详细教程，有需要的小伙伴可以参考下
2017-12-12
Python协程原理全面分析
协程（co-routine，又称微线程、纤程）是一种多方协同的工作方式。协程不是进程或线程，其执行过程类似于Python函数调用，Python的asyncio模块实现的异步IO编程框架中，协程是对使用async关键字定义的异步函数的调用
2023-02-02
python神经网络VGG16模型复现及其如何预测详解
这篇文章主要为大家介绍了VGG16模型的复现及其详解（包含如何预测），有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-05-05