xadmin常用樣式功能

文章目錄

• • model_icon 菜單圖標
  • style_fields
  • list_display
  • search_fields
  • list_filter
  • date_hierarchy
  • ordering
  • fields
  • filter_horizontal
  • raw_id_fields
  • list_editable
  • readonly_fields
  • exclude
  • refresh_times
  • show_detail_fields
  • relfield_style
  • 修改 xadmin 的主題 、title、header、菜單樣式
  • settings中配置中文、時區
  • 設置xadmin的app標題

xadmin可以使用的頁面樣式控制基本與Django原生的admin一直。

list_display 控制列表展示的字段
search_fields 控制可以通過搜索框搜索的字段名稱，xadmin使用的是模糊查詢
list_filter 可以進行過濾操作的列
ordering 默認排序的字段
readonly_fields 在編輯頁面的只讀字段
exclude 在編輯頁面隱藏的字段
list_editable 在列表頁可以快速直接編輯的字段
show_detail_fileds 在列表頁提供快速顯示詳情信息
refresh_times 指定列表頁的定時刷新
list_export 控制列表頁導出數據的可選格式
show_bookmarks 控制是否顯示書籤功能
data_charts 控制顯示圖標的樣式
model_icon 控制菜單的圖標

model_icon 菜單圖標

model_icon 參考http://fontawesome.dashgame.com/

效果圖

style_fields

控制字段的顯示樣式

默認manytomany字段樣式是個單排下拉框，對添加選項操作十分不友好

level是我model中的一個多對多字段

m2m_transfer就是多對多穿梭框樣式

ueditor是支持富文本編輯

filter_horizontal是多對多樣式字段支持過濾

list_display

指定xadmin中需要顯示哪些字段信息，以列表顯示

list_display = ('first_name', 'last_name', 'email')

search_fields

指定哪些字段信息可以被搜索

search_fields = ('first_name', 'last_name')

list_filter

添加哪些字段需要進行過濾顯示（添加過濾器)

list_filter = ('publication_date',)  #添加過濾（這裏是過濾日期）

date_hierarchy

添加日期過濾器，該字段只能是日期類型

date_hierarchy = 'publication_date'   #過濾（日期的另外一種過濾方式，可以添加後看一下）

ordering

顯示的列表以什麼進行排序 ，加‘-’表示降序

ordering = ('-publication_date',)   #排序（這裏以日期排序，加‘-’表示降序）

fields

排除一些不想被其他人編輯的fields，不包含在內的字段不能編輯

fields = ('title', 'authors', 'publisher')

filter_horizontal

從‘多選框’的形式改變爲‘過濾器’的方式，水平排列過濾器，必須是一個 ManyToManyField類型，且不能用於 ForeignKey字段，默認地，管理工具使用下拉框 來展現外鍵 字段

filter_horizontal = ('authors',)

raw_id_fields

將ForeignKey字段從‘下拉框’改變爲‘文本框’顯示

raw_id_fields = ('publisher',)

list_editable

列表顯示的時候，指定的字段可以直接頁面一鍵編輯

list_editable = ['csdevice']

readonly_fields

指定一些字段爲只讀，不可修改

readonly_fields = ('cservice',)

exclude

在編輯和查看列表時指定不顯示的字段

exclude = ['cservice']

refresh_times

後臺可選擇10秒刷新一次或者60秒刷新一次如下

refresh_times = [10, 60]

show_detail_fields

在指定的字段後添加一個顯示數據詳情的一個按鈕

show_detail_fields=['ttdsn']

relfield_style

後臺自定義不是下拉選擇框，而是搜索框（解決了爲什麼用戶不是下拉框的問題。。）

relfield_style = 'fk-ajax'

修改 xadmin 的主題 、title、header、菜單樣式

settings中配置中文、時區

# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'zh-hans'

# TIME_ZONE = 'UTC'
TIME_ZONE = 'Asia/Shanghai'

設置xadmin的app標題

在apps.py文件中，添加verbose_name = "客戶管理"

from django.apps import AppConfig
class CustomersConfig(AppConfig):
    name = 'apps.customers'
    verbose_name = "客戶管理"