教育行业A股IPO第一股(股票代码 003032)

全国咨询/投诉热线:400-618-4000

Django中提供的常用列表页选项

更新时间:2022年03月18日11时18分 来源:传智教育 浏览次数:

Django提供了一些选项来控制列表页的显示字段、搜索字段、过滤器等等,这些选项在应用的admin.py文件的模型管理类中使用。接下来以Goods模型为例,对常用列表页选项进行介绍。

1. list_display 选项

list_display 选项用于控制页面展示的字段,该选项的值为元组或列表类型,其中的元素可以是模型字段或自定义字段。

(1)模型字段名

使用list_display控制在页面中显示商品id和商品名称,示例如下:

list_display = ('id', 'name')                #元组形式
list_display = ['id', 'name']                #列表形式

(2)自定义字段

自定义字段指与模型相关,但并不包含在模型中的字段,这种字段是定义在goods/admin.py文件中的一些函数,这些函数会将模型实例作为参数。

例如,在goods/admin.py文件中定义用于显示商品销售额的自定义字段“salves_volume”,并使用sales_volume.short_description 设置该字段的功能说明。示例代码如下:

from .models import Goods
g = Goods()
def sales_volume(g):
  salea = g.price * g.sales
  return"{销售额为:{}元".foxmat(g.name,sales)
sales_volume.short_description='商品销售额'

以上代码首先实例化模型类Goods,然后将实例化的模型类作为参数传递到定义的salves_volumeO函数中计算商品销售额。

使用list_display 选项控制显示salves_volume字段,代码如下:

(admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
list_display = (sales_volume,)

以上代码在应用的admin.py文件中定义了Goods模型的管理类GoodsAdmin,在该类中通过 list_display 选项指定要显示的字段。

此时,刷新数据列表,可查看自定义字段显示的数据,如下图所示。

list_display 选项

2. list_display_links选项

list_display_links选项用于设置需在页面中以链接形式展示的字段,例如:

list_display_links = ('id', 'name')

此时页面中的id和name字段将以链接形式展示,如下图所示。

list_display_links选项

单击图6-14中商品列表部分id字段或name字段中的链接,可进入相应记录的编辑页面。

3.list_filter选项

list_filter选项用于开启列表页过滤器,该选项可以接收模型中的字段作为过滤条件,也可接收自定义过滤器。

(1)按模型字段进行过滤

以Goods模型为例,使用list_filter设置在页面中以商品名称作为过滤条件,示例如下:

list_filter = ('name',)                         # 以name作为过滤字段

列表页的过滤器会在页面右侧展示,如图所示:

list_filter选项

(2)自定义过滤器

list_filter也支持自定义过滤器。Goods模型的数据根据商品名称可分为“Apple Mac Pro”、“Apple iPhone”、“华为”和“小米”四种类别,下面自定义根据商品类别进行筛选的过滤器。

自定义过滤器本质上是一个类,该类需要继承admin.SimpleListFilter类,并重写lookups()与queryset()方法,其中lookups()方法用于设置分类,queryset()方法用于查询分类数据。在admin.py中自定义过滤器类,示例代码如下:

class BrandListFilter(admin.SimpleListFilter):
title='商品名称'
parameter_name = 'brand_name'
def lookupa(self, request, model_admin):
   return (
     ('0', ('Apple MacBook Pro')),
     ('1', ('Apple iPhone')),
    ('2',('华为')),
    (*3’,(‘小米’)),
  )
def queryset(self, request, queryset):
   if self.value() == '0':
      return queryset.filter(name__istartswith='Apple MacBook Pro')
   if self.value() == '1':
      return queryset.filter(name__istartswith='Apple iPhone')
   if self.value() == '2':
      return queryset.filter(name__istartswith='华为')

以上代码定义的自定义过滤器中,类属性title表示列表页上过滤器的名称,类属性 parameter_name表示访问路由中所携带的参数名称;looksupsO方法返回一个二维元组,内层元组中的第一个元素是字符串类型的查询编号,第二个元素是过滤器类别名称元组;querysetO方法根据查询编号进行筛选,返回一个QuerySet对象。

在模型管理器中将自定义的过滤器添加到list_filter,示例如下:

class GoodsAdmin(admin.ModelAdmin):
‥‥
list_filter = (BrandListEilter,)

刷新选择商品来修改页面,可看到自定义的过滤器,具体如图6-16所示。

自定义的过滤器

4.list_per_page选项

选择商品来修改页面默认每页显示100条数据,使用list_per_page选项可以设置每页显示的数据量。例如,设置每页显示5条记录,示例如下:

list_per_page = 5 # 每页展示5条记录
刷新选择商品来修改页面,此时页面效果如图6-17所示。
list_per_page选项
图6-18设置可编辑字段数据编辑完毕后,下拉到页面底部,单击“保存”按钮可保存修改后数据。

6.search_fields选项

search_fields选项用于配置搜索字段,示例代码如下:

search_fields = ('name',)#           表示以name作为搜索字段
以上代码设置在选择商品来修改页面以商品名称做为搜索条件,此时刷新页面,页面中将出现一个搜索框,具体效果如图6-19所示。 
search_fields选项

7.actions_on_top选项

actions_on_top选项用于设置是否在顶部显示动作下拉框,默认为True,表示在顶部显示,效果如图6-20所示。

图6-20默认效果修改actions_on_top选项为Flase,那么页面顶部不会再显示动作,代码如下:

actions_on_top = False
保存设置,刷新页面,效果如图6-21所示。

actions_on_top选项

8.actions_on_bottom选项

actions_on_bottom选项用于设置管理员动作是否在底部显示,默认为False,表示不在底部显示,当设置为True表示在底部显示。

9.actions选项

actions选项用于设定管理员动作。列表页默认提供“删除所选”动作,管理员选定商品后选择“删除所选”动作,再单击“执行”按钮,选定的商品会被删除。a

ctions选项也支持自定义管理员动作。自定义管理员动作的本质是在管理类中新增一个方法,并将该方法添加到actions选项中。例如,现需要将图6-21中的商品数据保存到Excel文件中,此时可在admin.py文件中定义下载商品信息动作。具体代码如下:

from django.http import HttpResponse
from django.utils.encoding import escape_uri_path
from openpyxl import Workbook
@admin.register (Goods)
class GoodsAdmin(admin.ModelAdmin):
    ...
    def download_excel(self, request, queryset):
        file_name='商品信息.xlsx'
        meta = self.model._meta
        #模型所有字段名
        field_names = [field.name for field in meta.fields]
        ≠定义响应内容类型
        response = HttpResponse(content_type='application/msexcel')
        #定义响应数据格式
        response['Content-Disposition'] = attachment;
        filename*=utf-8''{}.format(escape_uri_path(file_name))
        wb=workbook#创建文件对象
        ws= wb.active#使用当前活动的sheet表
        ws.append(['ID',‘创建时间,,‘更新时间','商品名称,
                  价格,,·库存,,·销量’])    #将模型字段名作为标题写入第一行
        for obj in queryset:                 #遍历选择的对象列表
           for field in field_names:
           #将模型属性值的文本格式组成列表
           data = [getattr(obj, field) for field in field_names]
        ws.append(data)    #写入模型属性值
        wb.save (response) #将数据存入响应内容
        return response
download_excel.short_description="下载商品信息"

以上示例代码在GoodsAdmin类中定义了方法download_excel()来实现“下载商品信息”的功能,该方法通过openpyxl模块将列表页中的商品数据写入到Excel文件中,如果当前Python环境中没有此模块,可使用pip命令进行安装。使用openpyxl模块时需先创建文件对象;然后通过文件对象的active属性获取Excel文件中的Sheet表,通过append()方法将标题行写入到excel文件;最后使用save()方法保存写入的数据。

download_excel()方法定义完成后,将其添加到actions选项中,示例如下:

actions = (download_excel,)

再次刷新选择商品来修改页面,在动作下拉框中可以看到自定义的动作已被添加,如图6-22所示。

actions选项

单击图6-22中的“执行”按钮下载所选商品信息,打开下载的Excel文件,保存的商品信息如图6-23所示。

actions选项






猜你喜欢:

Python怎样添加、删除、修改列表元素?

文本数据分析有什么作用?

什么是交叉验证?什么是网格搜索?

机器学习中入门级必学的算法有哪些?

传智教育人工智能开发课程

0 分享到:
和我们在线交谈!