xadmin 组件拓展自定义使用

骑猪看日落 2022-01-12 13:17 223阅读 0赞

# xadmin 组件相关可选自定义字段 #

## list\_display ##

### 功能 ###

设置默认的显示字段(列)

### 配置 ###

list_display = ['name', 'desc', 'detail', 'degree', 'learn_time', 'students',
                     'fav_nums', 'click_nums', 'add_time', 'get_zj_nums', 'go_to']  
    # 自己定义的函数也可以被当做字段来展示, 展示结果为函数的运算结果 ( 返回值 )

### 效果 ###

显示列中也可以手动更改显示字段 ( 列 ), 但是下次刷新的时候会恢复为只显示 list\_display 中的字段 ( 列 )

![1450319-20190406133738398-88658884.png][]

### ps 自定义函数的字段显示 ###

在相关的 model 中设置一段逻辑实现某些功能, 默认如果未配置 short\_description 会以函数名为显示字段

设置后则用设置值为xadmin后台显示字段名, 显示内容为函数返回值

# 定义自定义的一个跳转字段, 内部为html代码的形式
    def go_to(self):
        from django.utils.safestring import mark_safe
        return mark_safe("<a href='http://wwww.baidu.com'>跳转</a>")
    go_to.short_description = "跳转"

## search\_fields ##

### 功能 ###

设置搜索字段索引

### 配置 ###

放入列表的字段可以被视为可被搜索域

search_fields = ['name', 'desc', 'detail', 'degree', 'students', 'fav_nums', 'click_nums']

### 效果 ###

###  ![1450319-20190406133835654-2061233181.png][] ###

## list\_filter ##

### 功能 ###

设置过滤器

### 配置 ###

list_filter = ['name', 'desc', 'detail', 'degree', 'learn_time', 'students', 'fav_nums', 'click_nums','add_time']

### 效果 ###

不同类型的字段会展示出不同的过滤选项

![1450319-20190406134214878-1065246581.png][]

![1450319-20190406134229606-139247114.png][]

![1450319-20190406134255741-1287236999.png][]

![1450319-20190406134313507-1915625860.png][]

## ordering ##

### 功能 ###

初始展示时的默认排序方式

### 配置 ###

ordering = ['-click_nums']

### 效果 ###

其他的字段也可以进行手动的选择排序,刷新后恢复为默认排序

###  ![1450319-20190406134659631-605475265.png][] ###

![1450319-20190406134806699-1187225922.png][]

## readonly\_fields ##

### 功能 ###

设置只读字段, 不可编辑

### 配置 ###

readonly_fields = ['fav_nums']

### 效果 ###

进入编辑页面后此字段是无法修改的状态

![1450319-20190406134925529-1861507646.png][]

## exclude ##

### 功能 ###

设置不可见, 隐藏字段

### 配置 ###

**readonly\_fields** 和 **exclude** 是冲突的, 两个都设置会让 exclude 失效以只读显示

exclude = ['click_nums']

### 效果 ###

设置前

![1450319-20190406135323102-1113137244.png][]

设置后

![1450319-20190406135403973-1781549674.png][]

## list\_editable ##

### 功能 ###

配置可编辑字段, 无需进入编辑页面即可编辑相关字段内容

### 配置 ###

list_editable = ['degree', 'desc']

### 效果 ###

![1450319-20190406135727695-458504053.png][]

![1450319-20190406135743557-263899707.png][]

## refresh\_times ##

### 功能 ###

设置 xadmin 后台刷新频率

### 配置 ###

列表内的内容为单位秒, 设置多个为可选项

refresh_times = [3,5]

### 效果 ###

![1450319-20190406140447655-1918794177.png][]

## inlines ##

### 功能 ###

设置外键字典内容可被修改

### 配置 ###

在此处应用场景中, Course 表有两个反向的外键字段连接到 Lesson表 和 CourseResource 表

为了实现在编辑 Course表的时候就可以更方便的一起把 此表相关联的 这两个字段内容改了会很舒服

进行此项设置, 需要提前写一个类, 内置两个字典 为 model 表名和 extar = 0 然后加入到 inlines 中

class LessonInline(object):
        model = Lesson
        extar = 0
    
    
    class CourseResourceInline(object):
        model = CourseResource
        extar = 0

inlines = [LessonInline, CourseResourceInline]

### 效果 ###

课程表中是没有章节字段和课程资源字段的( 因为是反向外键设置 ), 设置此字段后

这样我们在更改课程的时候就也可以顺带着添加章节和课程资源了. 就用户体验而言是很舒服的

![1450319-20190406141210709-1339979318.png][]

当然你如果不设置此字段,想添加外键实际上也可以通过外层的时候的最后面的符号进行所有的外键操作, 不如在里面添加来的直观和舒适

![1450319-20190406141538015-789620520.png][]

## queryset ##

### 功能 ###

将一张表根据某个字段作为区分为多表

### 配置 ###

若想实现上下分表则需要重写 queryset 方法

此处配置为 以 is\_banner 作为标识区分,原表中 所有 is\_banner = False 的数据被筛选出来

def queryset(self):  # 实现上下分表, 将轮播课程另外显示
        qs = super(CourseAdmin, self).queryset()
        qs = qs.filter(is_banner=False)
        return qs

在model 中需要做此设置, 继承原表, proxy 设置为 True

class BannerCourse(Course):
        class Meta:
            verbose_name = "轮播课程"
            verbose_name_plural = verbose_name
            proxy = True  # 不设置这个就会再生成一张表

然后在 adminx 中在将此模型进行 注册, 同原表 Course 一样的注册方式 ( xadmin 会视其为另一张表 )

此时的 重写 queryset 则为 is\_banner = True 和原表进行上下分离

# 轮播课程注册
    class BannerCourseAdmin(object):
        list_display = ['name', 'desc', 'detail', 'degree', 'learn_time', 'students', 'fav_nums', 'click_nums', 'add_time']
        search_fields = ['name', 'desc', 'detail', 'degree', 'students', 'fav_nums', 'click_nums']
        list_filter = ['name', 'desc', 'detail', 'degree', 'learn_time', 'students', 'fav_nums', 'click_nums', 'add_time']
        ordering = ['-click_nums']
        readonly_fields = ['fav_nums']
        exclude = ['click_nums']
        inlines = [LessonInline, CourseResourceInline]
    
        def queryset(self):
            qs = super(BannerCourseAdmin, self).queryset()
            qs = qs.filter(is_banner=True)
            return qs

### 效果 ###

课程和轮播课程以是否轮播字段作为区分为两份表, 在 sql 中根源都是课程表

但是展示结果为

课程 = 不轮播的课程

轮播课程 = 轮播的课程

在 xadmin 中被视为两份独立的表分别进行各自定义的操作

![1450319-20190406142359258-1567206519.png][]

## save\_models ##

### 功能 ###

实现字段彼此的联动操作

### 配置 ###

此处的应用场景是 课程添加后, 课程结构的可选课程数量跟随加1 ( 本质是即时更新 )

def save_models(self):  # 在保存课程的时候统计课程机构的课程数
        obj = self.new_obj
        obj.save()
        if obj.course_org is not None:
            course_org = obj.course_org
            course_org.course_nums = Course.objects.filter(course_org=course_org).count()
            course_org.save()

### 效果 ###

不截图了.这个就是普通的数据更新, 没啥界面变化

转载于:https://www.cnblogs.com/shijieli/p/10661678.html

[1450319-20190406133738398-88658884.png]: /images/20220109/193b59123a6d47d38fbed764633a1374.png
[1450319-20190406133835654-2061233181.png]: /images/20220109/ad7e8a39ee1e4cccbee0720572a3a5b8.png
[1450319-20190406134214878-1065246581.png]: /images/20220109/1ead55127ef245398796ef4f83f5f11b.png
[1450319-20190406134229606-139247114.png]: /images/20220109/5fa2d77c2b6a42759437120dd78124d2.png
[1450319-20190406134255741-1287236999.png]: /images/20220109/7e815569b3ec482a95503f5e5ca84aa4.png
[1450319-20190406134313507-1915625860.png]: /images/20220109/9b65d5238b0b4bce867584786e5f627f.png
[1450319-20190406134659631-605475265.png]: /images/20220109/d86aa556716b46a389b07db0948461c0.png
[1450319-20190406134806699-1187225922.png]: /images/20220109/abb4be3e4eea47adb2fdc3321ce3eb22.png
[1450319-20190406134925529-1861507646.png]: /images/20220109/7399a352482546adac051b2f674ccc5a.png
[1450319-20190406135323102-1113137244.png]: /images/20220109/804a5f415b1940ccbd9373f377789bc6.png
[1450319-20190406135403973-1781549674.png]: /images/20220109/21be28b9646e49d9a9f492242af3861f.png
[1450319-20190406135727695-458504053.png]: /images/20220109/8eca102e24264d0bb5d03bb2a25c88de.png
[1450319-20190406135743557-263899707.png]: /images/20220109/16c70783354b40909ea332291402b844.png
[1450319-20190406140447655-1918794177.png]: /images/20220109/3ab0e97d16744472ba3f5e8bafc5916e.png
[1450319-20190406141210709-1339979318.png]: /images/20220109/b6e33a83fae64d69b58805652bc03898.png
[1450319-20190406141538015-789620520.png]: /images/20220109/d221b3e28c444996b3f1c369aedbe5b4.png
[1450319-20190406142359258-1567206519.png]: /images/20220109/197e032cd03e44e68d85ff8e9e037bb4.png