• python之Django学习笔记(五)---后台(admin.py)基础参数介绍


    在前面文章python之Django学习笔记(二)---Django从工程创建、app创建到表建模在页面的显示中已经提到了注册表就是在admin.py中完成

    已经涉及的修改是list_display,表示在界面显示哪些列,下面记录涉及到常用的后台操作

    1、注册表

    表必须在admin.py中注册后才能在界面上显示,所以注册表时第一步,一般代码如下:

    from django.contrib import admin
    from djangoTestApp.models import Student,Score#导入表
    
    # Register your models here.
    
    admin.site.register(Student)
    admin.site.register(Score)

    上面代码把之前建的3张表都注册了

    2、列表中显示列(list_display)

    之前讲过,就是在模型管理中使用list_display显示

    from django.contrib import admin
    from djangoTestApp.models import Student,Score
    
    # Register your models here.
    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age',)class ScoreAdmin(admin.ModelAdmin):
        list_display = ('No','Name','Course','Score')
    
    admin.site.register(Student,StudentAdmin)
    admin.site.register(Score,ScoreAdmin)

    上面创建的样式类需要继承admin.ModelAdmin类,名称一般都是表名+Admin

    一般情况下,如果有相同的名称时,list_display按照下面顺序解释元素:

    ★模型中表的字段

    ★callabled类型(自定义 函数)

    ★ModelAdmin属性

    ★模型属性

    3、编辑时显示列(fields)

    即在增加or编辑界面显示fields中的字段,如下为当前Student表在编辑界面展示的字段:

    上面左图为增加界面,右图为修改界面,显示了Student的4个字段

    在admin.py中加上fields字段只显示学号、姓名和年龄,如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        fields = ('No','Name','Age')#编辑界面只显示No、Name和Age

    这样在编辑界面只有这三个字段,少了‘性别’:

    fields还有调整列的顺序的功能,比如把No和Name对调一下

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        fields = ('Name','No','Age',)#No和Name顺序对调

    在界面上显示如下:

    如上图,学号和姓名已经调整了位置。

    fields还有使字段分布在同一行的功能,直到一行满了为止。比如说要把姓名和学号放到一排,那么可以如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        fields = (('Name','No',),'Age',)#Name和No一组,在同一行显示

    界面上如下图所示:

    4、编辑时不显示列(exclude)

    同fields字段相反,在exclude中的字段将不会显示。使用时不要把fields和exclude同时使用

    同上,如果不需要显示Sex字段,也可以直接写成如下,效果是一样的

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = ('No','Name','Age',)
        exclude = ('Sex',)#记得元祖需要在后面加个逗号,不然会报错

    5、编辑时页面布局(fieldsets)

    比如说把No和Name作为‘基本信息’字段集,把Age和Sex作为‘高级信息’字段集,代码可以做如下调整

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = (('Name','No',),'Age',)
        #exclude = ('Sex',)
        fieldsets = (
            ('基本信息',{
                    'fields':('No','Name',),
                },
            ),
            ('高级信息',{
                    'fields':('Sex','Age',),
                }
            )
        )

    说明下fields和fieldsets不能同时存在,系统会报错导致打不开。

    上面代码在界面上展示样式如下:

    如果不需要‘基本信息’这一行,可以在fieldsets中把‘基本信息’修改为None:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = (('Name','No',),'Age',)
        #exclude = ('Sex',)
        fieldsets = (
            (None,{#不显示
                    'fields':('No','Name',),
                },
            ),
            ('高级信息',{'fields':('Sex','Age',),
                }
            )
        )

    界面展示如下:

    也可以把不重要的信息折叠起来,这时会用到字段集的参数classes,如下把高级信息折叠起来:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = (('Name','No',),'Age',)
        #exclude = ('Sex',)
        fieldsets = (
            (None,{
                    'fields':('No','Name',),
                },
            ),
            ('高级信息',{
                    'classes':('collapse',),#把‘高级信息’默认折叠起来
                    'fields':('Sex','Age',),
                }
            )
        )

    在界面上展示如下,可以通过点击‘show’展开:

    classes还有另外一个样式:wide,即字段填写有更大的控件。

    字段集还有属性description,即描述,如果带有此属性,则会显示在 字段集下方,如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = (('Name','No',),'Age',)
        #exclude = ('Sex',)
        fieldsets = (
            (None,{
                    'fields':('No','Name',),
                },
            ),
            ('高级信息',{
                    'classes':('collapse',),
                    'description':'这里是高级信息的内容',#描述的内容
                    'fields':('Sex','Age',),
                }
            )
        )

    在界面上展示如下:

    6、编辑时样式字段(form)

    可以通过django.forms来定义不同的样式,然后在模型管理中调用这个样式,如下在admin.py中定义一个样式

    from django import forms#导入样式类
    
    class StudentForm(forms.ModelForm):
        class Meta:
            exclude = ('Sex',)

    上面代码就是让表Student不显示Age这个列,然后在StudentAdmin类中调用这个样式

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age')
        #fields = (('Name','No',),'Age',)
        #exclude = ('Sex',)
        form = StudentForm#调用自定义样式,之前的fieldsets注释掉

    上面这样调用和在模型管理中调用exclude效果是一样的,但若模型管理中也有exclude,那么优先使用模型管理中的。

    这个规则同样适用于其他样式比如fields、fieldsets等

    7、字段样式(format_html)

    在前面学习过字段聚合显示,这里的字段样式和之前差不多,比如把性别按照male和female分别显示蓝色和红色,具体操作如下

    ▲在models.py的Student表中增加如下代码:

    from django.utils.html import format_html
    
    class Student(models.Model):
        No = models.CharField('学号',max_length = 10)
        Name = models.CharField('姓名',max_length = 20)
        Sex = models.CharField('性别',max_length = 1,choices = SEX_CHOICE,default = 'M')
        Age = models.IntegerField('年龄')
    
        def colored(self):#定义显示的颜色,male显示蓝色,female显示红色
            if self.Sex == 'M':
                html =  '<span style="color: #0000FF;">{}</span>'
            else:
                html ='<span style="color: #FF0000;">{}</span>'
            return format_html(
                html,
                self.Sex,
            )
        colored.short_description = '性别'
        Sex_color = colored

    ▲在admin.py中修改展示的列

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)

    这时刷新页面,展示效果如下:

     8、非表字段可排序(admin_order_field)

    通过字段样式设置的字段,在展示后无法排序(即无法通过点击字段名排序),这里可以通过指定字段来排序

    (多个字段组合也可以指定,通过property装饰的字段都不能参与排序)

    在models.py中增加一行如下代码:

    class Student(models.Model):
        No = models.CharField('学号',max_length = 10)
        Name = models.CharField('姓名',max_length = 20)
        Sex = models.CharField('性别',max_length = 1,choices = SEX_CHOICE,default = 'M')
        Age = models.IntegerField('年龄')
        #Color = models.CharField(max_length = 6,default='FF0000')
    
        def colored(self):
            if self.Sex == 'M':
                html =  '<span style="color: #0000FF;">{}</span>'
            else:
                html ='<span style="color: #FF0000;">{}</span>'
            return format_html(
                html,
                #self.Color,
                self.Sex,
            )
        colored.short_description = '性别'
        colored.admin_order_field = 'Sex'#指定Sex可以参与排序
        Sex_color = colored

    刷新展示页面后就可以点击‘性别’字段排序了,当然也可以指定点击第一次以反序排列,只要在Sex前加‘-’即可,如下

    colored.admin_order_field = '-Sex'#指定Sex可以参与排序,先反序

    9、字段链接到编辑界面(list_display_links)

    在没有list_display_links字段时,默认情况list_displapy中第一个字段具有链接到编辑界面,如果需要其他字段链接到编辑界面,则可以使用此字段,如下设置

    class StudentAdmin(admin.ModelAdmin):
        def Age(self,obj):
            return  'xxx'
        list_display = ('NameNo','Sex_color','Age',)
        list_display_links = ('Age',)#设置年龄字段可链接到编辑界面

    刷新界面即可看到Age字段上的数据可以点击进入编辑界面:

    当然也可以设置所有字段都不可以点击进入编辑页面,只要设置为None即可

    class StudentAdmin(admin.ModelAdmin):
        def Age(self,obj):
            return  'xxx'
        list_display = ('NameNo','Sex_color','Age',)
        list_display_links = None#所有字段都不可点击进入编辑页面

     10、列表可编辑字段(list_editable)

     list_editable允许表字段可以在列表中直接进行编辑,也可以一次编辑多条数据,如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        list_display_links = None
        list_editable = ('Age',)#年龄字段在列表界面可直接编辑

    刷新界面后,样式如下:

    可以看到年龄字段可以直接进行编辑,无需再到编辑界面一个个编辑。

    使用list_editable有几个限制:

    ★list_editable中字段必须在list_display中

    ★list_editable中字段不能在list_display_links中,如果没有list_display_links则不能为list_display的第一个字段(也就是可链接到编辑界面的字段,无法在列表页直接编辑)

    ★list_editable不能设置非模型中表字段,也就是必须为原始表中的字段才可以设置

    11、过滤器(list_filter)

    显示在列表右侧的过滤器,算是快捷的过滤方法,一般用作boolean或者有限的值,如下

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        list_filter = ('Age',)#设置Age为过滤列
        list_display_links = None
        list_editable = ('Age',)

    刷新页面后如下所示:

    说明:非模型中原始表的列不能作为过滤对象

    list_filter还有种写法如下,感觉效果是一样的:

    list_filter = (('Sex',admin.ChoicesFieldListFilter,),)

    字段Sex是Choice类型,所以也可以这么写,当然还有其他类型如:RelatedFieldListFilter、BooleanFieldListFilter、ChoicesFieldListFilter、DateFieldListFilter等

    12、最多显示个数(list_max_show_all)

    在这个版本没看出来作用

    13、每页显示条数(list_per_page)

    我们设置list_per_page=4(默认100),那么Student中的6条数据会显示为俩页

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        list_filter = ('Age',)
        list_per_page = 4#每页显示4条数据
        list_max_show_all = 2
        list_display_links = None
        list_editable = ('Age',)

    刷新页面后显示如下:

    14、按照列排序(ordering)

    这个是进入表之后的排序,如果不设置,则默认按照数据录入顺序排列

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex','Age',)
        list_filter = ('Age',)
        ordering = ('-Age',)#年龄按照从大到小排列
        list_per_page = 10
        list_max_show_all = 2
        list_display_links = None
        list_editable = ('Age',)

    15、编辑时显示为只读(readonly_fields)

    即在编辑界面,设置的字段为只读,不可编辑。对非模型表原始字段也生效,若readonly_fields设置了非模型字段,则会在编辑界面显示,否则不显示

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        readonly_fields = ('Sex','NameNo')#设置性别、姓名(学号)为只读

    刷新界面后 显示如下:

    说明:在列表界面设置可编辑(list_editable)不冲突,俩边都可以自行设置为是否可编辑

    16、保存为新记录并停留在编辑界面(save_as)

    默认save_as=False,此时编辑界面有三个按钮:保存并新增、保存继续编辑、保存并跳转到列表页。

    修改为True之后,保存并新增选项会修改为保存为新纪录并跳转到新纪录的编辑界面,如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        save_as = True#保存为新纪录

    操作如下:

    17、保存为新纪录并跳转到列表页(save_as_continue)

    默认值为True,即保存并新增按钮会跳转到编辑页面,若为False则跳转到列表页面(只针对sava_as=True时生效)

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        save_as_continue = False#跳转到列表页面
        save_as = True

    18、在编辑界面顶部设置保存、删除按钮(save_on_top)

    默认为False,也就是在编辑界面保存、删除按钮都是在底部。若设置为True,保存、删除按钮也会存在顶部(底部按钮仍在)

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age',)
        save_on_top = True#设置删除、保存按钮在顶部

    19、搜索框(search_fields)

    默认是没有搜索框的,需要设置。在search_fields中的字段(必须为模型表字段)必须在list_display中存在(不一定为模型表字段),如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age')
        search_fields = ('Name',)#搜索姓名字段

    默认情况搜索框是按照queryset中icontains进行查询,若需要精确查询等,可以在字段上加对应的条件,如,需要精确查询姓名:

    search_fields = ('Name__exact',)#双下划线,精确查询姓名

    其他基本和queryset中filter类似,具体可以查看filter()方法

    20、是否在搜索框右侧显示列表总数(show_full_result_count)

    默认为True,即显示总数,如下所示:

    若设置为False

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age')
        show_full_result_count = False#设置不显示总数,只显示‘show all’

    则如下效果:

    和总数一样,show all也可以点击,然后显示所有记录

    21、设置列表页中的列表可排序(sortable_by)

    默认情况下模型表字段都可以排序,之前admin_order_field字段是让非模型表字段可排序。

    这里的sortable_by的的优先级高于admin_order_field。

    若sortable_by设置为空集,则所有字段都不可以排序。sortable_by可以把所有字段(包括非模型表字段)设置为可排序

    如设置NameNo设置为可排序:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age')
        sortable_by = ('NameNo',)#设置NameNo字段可排序

    这时其他字段都不可以排序。

    22、编辑页面右上角链接(view_on_site)

    默认True,使用get_absolute_url来显示(若没有则不显示)。若为False,则不会显示。

    当然也可以自定义view_on_site为callable,这样就可以显示对应返回的url,如下:

    class StudentAdmin(admin.ModelAdmin):
        list_display = ('NameNo','Sex_color','Age')
        def view_on_site(self, obj):
            return 'http://www.cnblogs.com/watertaro'#在编辑界面右上角显示主页

    刷新页面编辑界面如下:

    23、按时间搜索(date_hierarchy):

    只针对date或datetime类型数据,会在search_fields和Action之间出现一个按照时间搜索的插件

    在models.py中增加一张表Books:

    class Books(models.Model):
        No = models.CharField('编号',max_length = 10)
        Name = models.CharField('书名',max_length = 20)
        CreateTime = models.DateTimeField('创建时间',auto_now_add=True)
        UpdateTime = models.DateTimeField('更新时间',auto_now=True)
    
        def __str__(self):
            return 'No:' + self.No + ';TeacherName:' + self.Name + ';CreateTime:' + str(self.CreateTime)

    加完表之后在命令行中执行:

    python manage.py makemigrations#生成表改动文件
    python manage.py migrate#修改表

    在admin.py中增加如下代码:

    from djangoTestApp.models import Student,Score,Books#导入Books模型
    
    class BooksAdmin(admin.ModelAdmin):#增加后台操作
        list_display = ('No','Name','CreateTime','UpdateTime',)
        date_hierarchy = 'CreateTime'
        search_fields = ('Name',)
    
    admin.site.register(Books,BooksAdmin)#注册表

    此时刷新界面进入Bookss可以看到这边多了个如下框中的插件:

    官方文档

    完结!

  • 相关阅读:
    C++11 学习笔记 std::function和bind绑定器
    vue服务端渲染如何使用html模板
    vue服务端渲染的基本实现
    vscode实用6款插件
    $router.addRoutes()+vuex 动态添加路由
    Vue.extend()
    vue router滚动行为scrollBehavior
    vue路由精确匹配模式 exact
    redirect和alias的区别
    vue命名路由(name)的作用
  • 原文地址:https://www.cnblogs.com/watertaro/p/10603080.html
Copyright © 2020-2023  润新知