当前位置 博文首页 > Python Django 后台管理之后台模型属性详解

    Python Django 后台管理之后台模型属性详解

    作者:梦想橡皮擦 时间:2021-06-26 18:31

    十八、Django 后台模型属性篇

    继续在之前的项目中进行代码的编码,首先要回忆一下通过 createsuperuser 命令创建的管理员账号,如果忘记了,需要重新创建一个。

    本篇博客涉及的代码都在 admin.py 文件中,如果你首次打开本篇文章,请翻看本文结尾出的目录大纲,可以再次学习。

    为了便于学习,提前在 models.py 中新增一个类,代码如下:

    from django.db import models
    
    class MyCenter(models.Model):
        pass

    18.1 在 admin 中注册模型

    为了让 Django 能对 models.py 文件中的类进行管理操作,需要先注册模型。

    把上文提及的 MyCenter 模型进行注册,此时 admin.py 文件的代码如下:

    from django.contrib import admin
    from .models import MyCenter
    
    class MyCenterAdmin(admin.ModelAdmin):
        pass
    
    admin.site.register(MyCenter, MyCenterAdmin)

    注册成功的结果就是在后台页面,可以看到对模型的操作入口。

    Python Django 后台管理也要好好学之后台模型属性

    其它注册方式
    因为上述 MyCenterAdmin 没有实现任何功能,所以可以省略掉。修改代码如下:

    from django.contrib import admin
    from .models import MyCenter
    
    admin.site.register(MyCenter)

    同样可以使用装饰器达到相同的效果。

    from django.contrib import admin
    from .models import MyCenter
    
    
    @admin.register(MyCenter)
    class MyCenterAdmin(admin.ModelAdmin):
        pass

    18.2 Model.Admin 类提供的属性

    在上文你已经看到了,admin.py 文件中的类默认继承自 Model.Admin,既然继承自它,那接下来要掌握的就是它给我们提供的属性内容了。

    工作开始前,我们先将 admin.py 文件中的代码进行修改,主要为了便于页面展示。

    models.py

    from django.db import models
    from django.contrib.auth.models import User
    
    class Customer(models.Model):
        # 自增主键
        _id = models.AutoField(primary_key=True)
        name = models.CharField(max_length=20, verbose_name="客户名")
        mobile = models.IntegerField(default=0, verbose_name="手机号码")
    
    
    class Score(models.Model):
        # 自增主键
        _id = models.AutoField(primary_key=True)
        customer = models.ForeignKey(Customer, on_delete=models.CASCADE)
        score = models.IntegerField(default=0, verbose_name="分数")

    admin.py

    from django.contrib import admin
    from .models import Customer
    
    
    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        pass

    上述内容补充完整之后,就可以进行后台对数据进行维护了。

    Python Django 后台管理也要好好学之后台模型属性

    接下来就要学习第一个属性:date_hierarchy

    18.2.1 date_hierarchy

    该属性用于将时间列转换为可过滤字段,完成该操作需要在 models.py 中新增好 models.DateField 类型的字段。

    create_time = models.DateField(default=timezone.now)

    当模型发生变化,需要用下述命令进行一下同步。

    python manage.py makemigrations scoring
    python manage.py migrate

    模型变化迁移之后,就可以在 admin.py 中进行配置了。

    from django.contrib import admin
    from .models import Customer
    
    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        date_hierarchy = "create_time"

    此时再运行应用之后,就可以在 customer 页面查看到最终结果了。

    Python Django 后台管理也要好好学之后台模型属性

    18.2.2 actions_on_top/actions_on_bottom

    控制动作条的显示位置,动作即操作。

    Python Django 后台管理也要好好学之后台模型属性

    修改 admin.py 文件代码如下,可以控制动作条的展示位置。

    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        date_hierarchy = "create_time"
        # actions_on_top = False
        actions_on_bottom = True

    18.2.3 actions_selection_counter

    动作条后面的计数是否展示。当其设置为 False 之后,后面的数字消失。

    Python Django 后台管理也要好好学之后台模型属性

    18.2.4 list_display

    该属性可以控制模型中列表显示的字段。代码修改为如下内容:

    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        date_hierarchy = "create_time"
        actions_on_top = False
        actions_on_bottom = True
        list_display = ["_id", "name", "mobile", "create_time"]

    最终呈现的数据如下:

    Python Django 后台管理也要好好学之后台模型属性

    list_display 还可以给字段嵌套一个函数。

    def warp_name(obj):
        return f"客户名:{obj.name}"
    
    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        date_hierarchy = "create_time"
        actions_on_top = False
        actions_on_bottom = True
    
    	# warp_name 为函数名,函数内会接收一个对象
        list_display = ["_id", warp_name, "mobile", "create_time"]
        warp_name.short_description = "格式化的名字"

    也可以将上述代码的 warp_name 函数,放置到 CustomerAdmin 内部。

    @admin.register(Customer)
    class CustomerAdmin(admin.ModelAdmin):
        date_hierarchy = "create_time"
        actions_on_top = False
        actions_on_bottom = True
    
        def warp_name(self, obj):
            return f"客户名:{obj.name}"
    
        list_display = ["_id", 'warp_name', "mobile", "create_time"]
    
        warp_name.short_description = "格式化名字"

    此时最大的区别就是 list_display 的列表中自定义的函数为一个字符串形式。

    默认情况下 list_display 的第一项是超链接,点击可以进行编辑页面,可以通过 list_display_links 进行设置。

    • list_display_links:为 None 表示不显示任何链接;
    • 列表:标记哪些需要超链接。

    18.2.5 empty_value_display

    空数据展示的方式,默认空数据展示的是 --,使用该属性之后,可以进行自定义设置。
    修改 models.py 文件,增加备注列。

    class Customer(models.Model):
        # 自增主键
        _id = models.AutoField(primary_key=True)
        name = models.CharField(max_length=20, verbose_name="客户名")
        mobile = models.IntegerField(default=0, verbose_name="手机号码")
        create_time = models.DateField(default=timezone.now)
        mark = models.CharField(max_length=50, null=True, blank=True)

    重新运行迁移命令,然后运行应用,得到如下效果。

    Python Django 后台管理也要好好学之后台模型属性

    接下来使用该字段进行数据的展示,在 admin.py 文件中进行设置。

    empty_value_display = '/'

    运行之后得到的结果如下:

    Python Django 后台管理也要好好学之后台模型属性

    18.2.6 fields

    控制显示的表单字段与顺序组合。例如增加如下代码之后,核对结果如下:

    list_display = ["_id", 'warp_name', "mobile", "create_time","mark"]
    fields = ["mobile","name"]

    Python Django 后台管理也要好好学之后台模型属性

    18.2.7 其他要补充的属性

    filter_horizontalfilter_vertical
    筛选菜单的横排展示与竖排展示。

    list_editable
    可编辑字段。

    list_filter
    过滤器属性设置。

    list_per_page
    每页显示的数据条数。

    ordering
    排序字段列表。

    paginator
    分页类对象,需要提前引入 django.core.paginator.Paginator

    radio_fields
    字段在表单中是单选按钮。

    readonly_fields
    不可编辑字段。

    search_fileds
    列表页增加的筛选字段。

    js