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 中的字段 ( 列 )
ps 自定义函数的字段显示
在相关的 model 中设置一段逻辑实现某些功能, 默认如果未配置 short_description 会以函数名为显示字段
设置后则用设置值为xadmin后台显示字段名, 显示内容为函数返回值
# 定义自定义的一个跳转字段, 内部为html代码的形式def go_to(self): from django.utils.safestring import mark_safe return mark_safe("跳转")go_to.short_description = "跳转" search_fields
功能
设置搜索字段索引
配置
放入列表的字段可以被视为可被搜索域
search_fields = ['name', 'desc', 'detail', 'degree', 'students', 'fav_nums', 'click_nums']
效果
list_filter
功能
设置过滤器
配置
list_filter = ['name', 'desc', 'detail', 'degree', 'learn_time', 'students', 'fav_nums', 'click_nums','add_time']
效果
不同类型的字段会展示出不同的过滤选项
ordering
功能
初始展示时的默认排序方式
配置
ordering = ['-click_nums']
效果
其他的字段也可以进行手动的选择排序,刷新后恢复为默认排序
readonly_fields
功能
设置只读字段, 不可编辑
配置
readonly_fields = ['fav_nums']
效果
进入编辑页面后此字段是无法修改的状态
exclude
功能
设置不可见, 隐藏字段
配置
readonly_fields 和 exclude 是冲突的, 两个都设置会让 exclude 失效以只读显示
exclude = ['click_nums']
效果
设置前
设置后
list_editable
功能
配置可编辑字段, 无需进入编辑页面即可编辑相关字段内容
配置
list_editable = ['degree', 'desc']
效果
refresh_times
功能
设置 xadmin 后台刷新频率
配置
列表内的内容为单位秒, 设置多个为可选项
refresh_times = [3,5]
效果
inlines
功能
设置外键字典内容可被修改
配置
在此处应用场景中, Course 表有两个反向的外键字段连接到 Lesson表 和 CourseResource 表
为了实现在编辑 Course表的时候就可以更方便的一起把 此表相关联的 这两个字段内容改了会很舒服
进行此项设置, 需要提前写一个类, 内置两个字典 为 model 表名和 extar = 0 然后加入到 inlines 中
class LessonInline(object): model = Lesson extar = 0class CourseResourceInline(object): model = CourseResource extar = 0
inlines = [LessonInline, CourseResourceInline]
效果
课程表中是没有章节字段和课程资源字段的( 因为是反向外键设置 ), 设置此字段后
这样我们在更改课程的时候就也可以顺带着添加章节和课程资源了. 就用户体验而言是很舒服的
当然你如果不设置此字段,想添加外键实际上也可以通过外层的时候的最后面的符号进行所有的外键操作, 不如在里面添加来的直观和舒适
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 中被视为两份独立的表分别进行各自定义的操作
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()
效果
不截图了.这个就是普通的数据更新, 没啥界面变化