Python Django 後臺管理之後臺模型屬性詳解

Posted on by

十八、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_horizontal 與 filter_vertical
篩選菜單的橫排展示與豎排展示。

list_editable
可編輯字段。

list_filter
過濾器屬性設置。

list_per_page
每頁顯示的數據條數。

ordering
排序字段列表。

paginator
分頁類對象，需要提前引入 django.core.paginator.Paginator。

radio_fields
字段在表單中是單選按鈕。

readonly_fields
不可編輯字段。

search_fileds
列表頁增加的篩選字段。

到此這篇關於Python Django 後臺管理之後臺模型屬性的文章就介紹到這瞭,更多相關Python Django 後臺管理內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：