Django系列之关于bootstrap-table插件的简单使用

preface

我们在前端html页面的时候做表格最常用的就是jinja2渲染，这样的好处是无须引用外部插件，直接使用就行，方便。但是不好的就是前端CSS样式以及其他表格排序筛选功能需要自己写，增加了自己的代码量。为了提高前端的美观性以及功能性，我便开始使用第三方插件来做表格了。bootsrap-table这个插件，官网地址。
好了，废话不多说，我们开始说说怎么使用这个插件。

前端代码：

我们先看前端代码，这段代码插在html页面里面：
先简单解释下 罗列的参数：

• data-toggle： 不用写 JavaScript 直接启用表格。
• data-url ： 获取数据的url，可以使用jinja的写法。
• data-method： 获取数据的方法，建议写get，写post的话，django后端收不到post过来的数据。
• data-pagination 设置为 true 会在表格底部显示分页条
• data-side-pagination 设置分页的动作由后端django来做分页
• data-page-list： 设置可供选择的页面数据条数。设置为All 则显示所有记录。
• data-search： 启用搜索框
• searchOnEnterKey 设置为 true时，按回车触发搜索方法，否则自动触发搜索方法
• data-show-refresh： 是否显示刷新按钮
• data-show-columns 内容列下拉框，在右上角的。
• data-show-toggle 是否显示 切换试图（table/card）按钮
• data-page-size 默认分页大小20行
• data-unique-id 设置table的主键为哪一列
• data-striped 设置为 true 会有隔行变色效果
• data-sortable 允许这列排序
• data-field 表示这个列数据设置一个名字，后端传入数据过来的时候属于这列的数据也必须带有相同的名字。待会看看后端的代码就知道怎么回事了。

html前端代码

<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/bootstrap-table/1.11.1/bootstrap-table.min.css"> <table id="asset_list_table" class="display table table-hover" data-toggle="table" data-url="{% url 'show_asset_in_table' %}" data-method="get" data-pagination="true" data-side-pagination="server" data-page-list="[10, 20, 50, 100, 200]" data-search="true" data-mobile-responsive="true" searchOnEnterKey="true" data-show-refresh="true" data-show-columns="true" data-show-toggle="true" data-page-size=20 data-unique-id="asset_id" data-striped="true" > <thead > <tr> <th data-field="state" data-checkbox="true"></th> <th data-field="asset_id" data-align="center" data-sortable="true">资产ID(点击ID查看详情)</th> <th data-field="asset_sn" data-align="center" data-sortable="true" data-width="50px">资产编号</th> <th data-field="asset_business_unit" data-sortable="true">产品线</th> <th data-field="asset_name" data-align="center" data-sortable="true" data-class="asset_name">资产名</th> <th data-field="asset_management_ip" data-align="center" data-sortable="true" data-class="asset_management_ip">管理IP</th> <th data-field="asset_manufactory" data-sortable="true">厂商</th> <th data-field="asset_type" data-sortable="true">类型</th> <th data-field="asset_os_release" data-sortable="true">操作系统</th> <th data-field="asset_salt_minion_id" data-sortable="true">saltminion_id</th> <th data-field="asset_cpu_model" data-sortable="true">CPU型号</th> <th data-field="asset_cpu_count" data-sortable="true">CPU个数</th> <th data-field="asset_cpu_core_count" data-sortable="true">CPU总核数</th> <th data-field="asset_rams_size" data-sortable="true">内存大小（MB）</th> <th data-field="asset_localdisks_size" data-sortable="true">磁盘总空间（GB）</th> <th data-field="asset_admin" >资产管理员</th> <th data-field="asset_idc" data-sortable="true">机房名</th> <th data-field="asset_trade_date" data-sortable="true">购买日期</th> <th data-field="asset_create_date" data-sortable="true">创建日期</th> </tr> </thead> <script src="https://img.hcharts.cn/jquery/jquery-1.8.3.min.js"></script> <!-- Latest compiled and minified JavaScript --> <script src="/static/js//bootstrap-table.min.js"></script> <script src="/static/js/bootstrap.min.js"></script> <!-- Latest compiled and minified Locales --> <script src="/static/js/bootstrap-table-zh-CN.min.js"></script> 

django-url路由匹配：

在url里面写的

urlpatterns = [
    url(r'asset_show_table',views.show_asset_in_table,name='show_asset_in_table'),  # 展示资产信息在bootstrap-table里面
    ]

djang-views的代码

这段代码是views里面的，里面的limit,offset，search，sort_column,order都是bootstrap-table插件在请求数据的时候会加上的，所以说我们需要在views里面去判断是否有这些参数。

• limit 表示每页有多少条记录
• offset 表示总共有多少条记录从数据库里获取的时候。
• search 搜索的关键字。
• sort_column 表示哪一列需要排序。
• order 表示排序是升序还是降序。

from django.db.models import Count,Sum

def get_ram_sum_size(asset_id): ''' get the size of RAM and disk in total :param asset_id: asset's id :return: the size of RAM in total ''' all_ram_slot = models.RAM.objects.filter(asset__id=asset_id) all_disk_slot = models.Disk.objects.filter(asset__id=asset_id) ram=0 for slot in all_ram_slot: ram=ram+slot.capacity disk = 0 for slot in all_disk_slot: disk = disk+slot.capacity return ram,disk def show_asset_in_table(request): ''' 专门处理在服务器资产列表里面的表格信息的方法 :param request: :return: ''' if request.method == "GET": print(request.GET) limit = request.GET.get('limit') # how many items per page offset = request.GET.get('offset') # how many items in total in the DB search = request.GET.get('search') sort_column = request.GET.get('sort') # which column need to sort order = request.GET.get('order') # ascending or descending if search: # 判断是否有搜索字 all_records = models.Asset.objects.filter(id=search,asset_type=search,business_unit=search,idc=search) else: all_records = models.Asset.objects.all() # must be wirte the line code here if sort_column: # 判断是否有排序需求 sort_column = sort_column.replace('asset_', '') if sort_column in ['id','asset_type','sn','name','management_ip','manufactory','type']: # 如果排序的列表在这些内容里面 if order == 'desc': # 如果排序是反向 sort_column = '-%s' % (sort_column) all_records = models.Asset.objects.all().order_by(sort_column) elif sort_column in ['salt_minion_id','os_release',]: # server__ 表示asset下的外键关联的表server下面的os_release或者其他的字段进行排序 sort_column = "server__%s" % (sort_column) if order == 'desc': sort_column = '-%s'%(sort_column) all_records = models.Asset.objects.all().order_by(sort_column) elif sort_column in ['cpu_model','cpu_count','cpu_core_count']: sort_column = "cpu__%s" %(sort_column) if order == 'desc': sort_column = '-%s'%(sort_column) all_records = models.Asset.objects.all().order_by(sort_column) elif sort_column in ['rams_size',]: if order == 'desc': sort_column = '-rams_size' else: sort_column = 'rams_size' all_records = models.Asset.objects.all().annotate(rams_size = Sum('ram__capacity')).order_by(sort_column) elif sort_column in ['localdisks_size',]: # using variable of localdisks_size because there have a annotation below of this line if order == "desc": sort_column = '-localdisks_size' else: sort_column = 'localdisks_size' # annotate 是注释的功能,localdisks_size前端传过来的是这个值，后端也必须这样写，Sum方法是django里面的，不是小写的sum方法， # 两者的区别需要注意，Sum（'disk__capacity‘）表示对disk表下面的capacity进行加法计算，返回一个总值. all_records = models.Asset.objects.all().annotate(localdisks_size=Sum('disk__capacity')).order_by(sort_column) elif sort_column in ['idc',]: sort_column = "idc__%s" % (sort_column) if order == 'desc': sort_column = '-%s'%(sort_column) all_records = models.Asset.objects.all().order_by(sort_column) elif sort_column in ['trade_date','create_date']: if order == 'desc': sort_column = '-%s'%sort_column all_records = models.Asset.objects.all().order_by(sort_column) all_records_count=all_records.count() if not offset: offset = 0 if not limit: limit = 20 # 默认是每页20行的内容，与前端默认行数一致 pageinator = Paginator(all_records, limit) # 开始做分页 page = int(int(offset) / int(limit) + 1) response_data = {'total':all_records_count,'rows':[]} # 必须带有rows和total这2个key，total表示总页数，rows表示每行的内容 for asset in pageinator.page(page): ram_disk = get_ram_sum_size(asset.id) # 获取磁盘和内存的大小 # 下面这些asset_开头的key，都是我们在前端定义好了的，前后端必须一致，前端才能接受到数据并且请求. response_data['rows'].append({ "asset_id": '<a href="/asset/asset_list/%d" target="_blank">%d</a>' %(asset.id,asset.id), "asset_sn" : asset.sn if asset.sn else "", "asset_business_unit": asset.business_unit if asset.business_unit else "", "asset_name": asset.name if asset.name else "", "asset_management_ip": asset.management_ip if asset.management_ip else "", "asset_manufactory": asset.manufactory.manufactory if hasattr(asset,'manufactory') else "", "asset_type": asset.asset_type if asset.asset_type else "", "asset_os_release": asset.server.os_release if hasattr(asset,'server') else "", "asset_salt_minion_id":asset.server.salt_minion_id if hasattr(asset,'server') else "", "asset_cpu_count":asset.cpu.cpu_count if hasattr(asset,'cpu') else "", "asset_cpu_core_count": asset.cpu.cpu_core_count , "asset_cpu_model": asset.cpu.cpu_model if hasattr(asset,'cpu') else "", "asset_rams_size": ram_disk[0] if ram_disk[0] else "", "asset_localdisks_size" : ram_disk[1] if ram_disk[1] else "", "asset_admin": asset.admin.username if asset.admin else "", "asset_idc": asset.idc if asset.idc else "", "asset_trade_date": asset.trade_date.strftime('%Y-%m-%d %H:%M') if asset.trade_date else "", "asset_create_date" : asset.create_date.strftime("%Y-%m-%d %H:%M") if asset.create_date else "", "update_date": asset.update_date.strftime("%Y-%m-%d %H:%M") if asset.update_date else "", }) return HttpResponse(json.dumps(response_data)) # 需要json处理下数据格式 

需要注意的就是后端返回的数据要json格式的，且是字典的，带有total,rows这两个key，total表示总页数，rows是每一行的记录，每一行的记录必须是以asset_开头，因为前端我们是这样定义的，所以前后端必须保持一致。

转载于:https://www.cnblogs.com/POSLINKS/p/8464516.html