使用bootstrap table可以很方便的开发后台表格,对数据进行异步更新,编辑。下面就来介绍一下bootstrap table的详细使用方法:
因为之前在官网也找了很久的教程,源码感觉隐藏的比较隐秘,其他扩展功能也很难找到,其实都在:http://issues.wenzhixin.net.cn/bootstrap-table/index.html这里面,点击上面的tab可以找到具体的功能实现(特别是extension和issues,之前以为issues不是教程,结果点进去才知道):
最简单的异步表单
1.html中加入如下代码:
<table id="table"></table>
- 1
2.javascript
/*bootstrap table*/
$('#table').bootstrapTable({
url:"/wadmin/permission/doRuleList",//请求数据url
queryParams: function (params) {
return {
offset: params.offset, //页码
limit: params.limit, //页面大小
search : params.search, //搜索
order : params.order, //排序
ordername : params.sort, //排序
};
},
showHeader : true,
showColumns : true,
showRefresh : true,
pagination: true,//分页
sidePagination : 'server',//服务器端分页
pageNumber : 1,
pageList: [5, 10, 20, 50],//分页步进值
search: true,//显示搜索框
//表格的列
columns: [
{
field: 'id',//域值
title: '规则ID',//标题
visible: true,//false表示不显示
sortable: true,//启用排序
width : '5%',
},
{
field: 'name',//域值
title: '唯一英文标识',//标题
visible: true,//false表示不显示
sortable: true,//启用排序
width : '30%',
editable:true,
},
{
field: 'title',//域值
title: '中文描述',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '35%',
editable:true,
},
{
field: 'status',//域值
title: '状态',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '20%',
formatter : function (value, row, index) {
if (row['status'] === 1) {
return '正常';
}
if (row['status'] === 0) {
return '禁用';
}
return value;
}
}
]
});
上面代码中,除了url和下面的column需要动态变之外,其他的基本上都是固定的,可以复制粘贴到处使用。因为规则的固定,所以后台的规则也是比较固定的。
3.thinkPHP5.0实现后台(主要是返回total和rows)
controller
public function doRoleRuleList() {
$id = input("id");
if (!$id) return "";
$limit = input("limit");
$offset = input("offset");
$search = input("search");
$order = input("order", "desc");
$ordername = input("ordername");
if (!$ordername) {
$ordername = 'id';
$order = 'desc';
}
$perModel = new PermissionModel();
$rs = $perModel->doRoleRuleList($id, $offset, $limit, $search, $order, $ordername);
return json($rs);
}
model
public function doRoleRuleList($id, $offset, $limit, $search, $order, $ordername) {
$total = Db::connect("dbUser")->table("auth_rule")->where(['status'=>['<>', 0]])->count();
$auth_group = Db::connect("dbUser")->table("auth_group")->field("id,rules")->where("id", $id)->find();
$rules ="-1";
if ($auth_group && $auth_group['rules']) $rules = $auth_group['rules'];
$rows = Db::connect("dbUser")->table("auth_rule")
->field(['id','name','title',"if(id in ({$rules}), 1, 0)"=>'selected'])
->where([
'status'=>['<>', 0],
// 'name|title' => ['like', "%{$search}%"]
])
->order($ordername." ".$order)
->select();
return ['total'=>$total,'rows'=>$rows];
}
说明图:
复杂表格(行内编辑(编辑文字,下拉选择),样式改变,自定义图标,文件上传),因为js比较复杂,这里先列出代码功能的说明:
1.显示详情使用如下代码:
表格参数中添加代码
detailView : true,
detailFormatter : function (index, row) {
var image = '<div class="photos">'
+'<a target="_blank" href="'+row['jumpUrl']+'"><img alt="image" class="feed-photo" src="'+row['picUrl']+'"></a>'
+'</div>';
return image;
}
可以在detailFormatter进行代码的格式化,以字符串的形式返回即可,实现效果如下:
2.表格列内容的格式化
列参数中添加代码
formatter : function (value, row, index) {
return "<img style='width: 50px;height: 50px;' src='"+value+"' alt=''>"
}
效果如下:
3 . 表格的样式自定义
列参数中添加带代码
cellStyle : function (value, row, index) {
return {
css: {
"max-width": "300px",
"word-wrap": "break-word",
"word-break": "normal"
}
};
}
4 . 新增数据
在js文件中添加如下代码:
$("#btn_add").click(function () {
$.ajax({
type : "POST",
url : "/wadmin/ad/addAd",
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '标签');
$("#table").bootstrapTable('insertRow', {index:0, row:data.data});
}
});
});
绑定的按钮是toolbar里面的,点击如果进行ajax请求,再根据请求的结果自行判断添加
5.表格中列格式化成图标并监听事件
6.文件上传(基于5)
列参数中添加如下代码
{
field: 'operate',
title: '操作',
align: 'center',
events: operateEvents,
width : '25%',
formatter: operateFormatter
}
operateFormatter(这里注意需要添加a标签包住图标,并添加class)
function operateFormatter(value, row, index) {
return [
'<a class="using" href="javascript:void(0)" title="Remove">',
'<i class="fa fa-check"></i>',
'</a> ',
'<a class="upload" style="cursor: pointer" href="javascript:void(0)" title="Upload">',
'<label style="cursor: pointer" for="'+row['adId']+'">',
'<i class="fa fa-upload"></i>',
'<input type="file" name="adUpload" style="display: none;" class="adUpload" id="'+row['adId']+'" >',
'</label>',
'</a> ',
'<a class="remove" href="javascript:void(0)" title="Using">',
'<i class="fa fa-times"></i>',
'</a>',
].join('');
}
operateEvents(监听事件,注意这里是window.operateEvents)
window.operateEvents = {
'click .remove': function (e, value, row, index) {
$.ajax({
type : "POST",
url : "/wadmin/ad/deleteAd",
data : {
adId : row['adId']
},
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '删除成功');
$("#table").bootstrapTable('remove', {
field: 'adId',
values: [row['adId']]
});
}
});
return false;
},
'click .using': function (e, value, row, index) {
$.ajax({
type : "POST",
url : "/wadmin/ad/usingAd",
data : {
adId : row['adId']
},
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '使用该广告');
$("#table").bootstrapTable('refresh');
}
});
return false;
},
'click .upload': function (e, value, row, index) {
$('.adUpload').fileupload({
url : '/wadmin/ad/adUpload/adId/'+row['adId'],
dataType: 'json',
add: function (e, data) {
data.submit();
},
done: function (e, data) {
var response = data.result;
if (response.result != 0) {
toastr.error(response.message);
return false;
}
toastr.success("上传成功");
$("#table").bootstrapTable('refresh');
}
});
return false;
}
};
实现的效果如下:
7.行内编辑
普通的编辑只需要在列参数中设置即可:
列参数中添加代码
editable : true,
- 1
需要下拉编辑的,使用如下代码:
editable: {
type: 'select',
source: [ //0->无广告,1->静态不可点击,2->静态可点击,3->动态不可点击,4->动态可点击
{value: 0, text: '无广告'},
{value: 1, text: '静态不可点击'},
{value: 2, text: '静态可点击'},
{value: 3, text: '动态不可点击'},
{value: 4, text: '动态可点击'},
]
}
这里还有一些行内编辑的样式是需要导入第三方lib的,比如说如果要实现行内时间的编辑,需要下载导入combodate.js
,然后添加如下代码(这些js文件后面会给出的,也可以去官网下载最新版):
editable: {
type: 'combodate',
viewformat: 'YYYY-MM-DD HH:mm:ss',
template: 'YYYY-MM-DD HH:mm:ss',
format: 'YYYY-MM-DD HH:mm:ss',
combodate: {
minuteStep: 1,
secondStep: 1,
maxYear: 5000,
minYear: 2016,
}
}
然后再表格参数中添加如下代码监听事件:
onEditableSave: function (field, row, oldValue, $el) {
$.ajax({
type: "post",
url: "/wadmin/ad/updateAdInfo",
dataType : 'json',
data: row,
success: function (data, status) {
if (status == "success" && data.result == 0) {
toastr.success('更新成功');
if (field == 'jumpUrl') {
$('#table').bootstrapTable("refresh");
}
return true;
} else {
toastr.info(data.message);
$('#table').bootstrapTable("refresh");
}
},
error: function () {
alert("Error");
},
complete: function () {
}
});
}
实现的效果如下:
其中,调用bootstraptable的一些方法可以动态更新表格(增删改等),用法如下:
$("#table").bootstrapTable('insertRow', {index:0, row:data.data});
$("#table").bootstrapTable('remove', {
field: 'adId',
values: [row['adId']]
});
$("#table").bootstrapTable('refresh');
$("#table").bootstrapTable('updateCell', {
index : index,
field: 'status',
value: row['status'] ? 0 : 1
});
因为引入的js和css库有点多,而且需要实现行内编辑的话需要需要引入的js文件比较难找,下面给出下载地址(密码:jjdk):
http://pan.baidu.com/s/1bpiRObt
完整代码
html
<div id="toolbar" class="btn-group">
<button id="btn_add" type="button" class="btn btn-default">
<span class="glyphicon glyphicon-plus" aria-hidden="true"></span>新增广告
</button>
</div>
<table id="table"></table>
javascript
/**
* Created by raid on 2016/12/28.
*/
$(function () {
window.operateEvents = {
'click .remove': function (e, value, row, index) {
$.ajax({
type : "POST",
url : "/wadmin/ad/deleteAd",
data : {
adId : row['adId']
},
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '删除成功');
$("#table").bootstrapTable('remove', {
field: 'adId',
values: [row['adId']]
});
}
});
return false;
},
'click .using': function (e, value, row, index) {
$.ajax({
type : "POST",
url : "/wadmin/ad/usingAd",
data : {
adId : row['adId']
},
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '使用该广告');
$("#table").bootstrapTable('refresh');
}
});
return false;
},
'click .upload': function (e, value, row, index) {
$('.adUpload').fileupload({
url : '/wadmin/ad/adUpload/adId/'+row['adId'],
dataType: 'json',
add: function (e, data) {
data.submit();
},
done: function (e, data) {
var response = data.result;
if (response.result != 0) {
toastr.error(response.message);
return false;
}
toastr.success("上传成功");
$("#table").bootstrapTable('refresh');
}
});
return false;
}
};
/*bootstrap table*/
$('#table').bootstrapTable({
url:"/wadmin/ad/doAdList",//请求数据url
toolbar : "#toolbar",
// toolbarAlign : "right",
queryParams: function (params) {
return {
offset: params.offset, //页码
limit: params.limit, //页面大小
search : params.search, //搜索
order : params.order, //排序
ordername : params.sort, //排序
};
},
detailView : true,
detailFormatter : function (index, row) {
var image = '<div class="photos">'
+'<a target="_blank" href="'+row['jumpUrl']+'"><img alt="image" class="feed-photo" src="'+row['picUrl']+'"></a>'
+'</div>';
return image;
},
showHeader : true,
showColumns : true,
showRefresh : true,
pagination: true,//分页
sidePagination : 'server',//服务器端分页
pageNumber : 1,
pageList: [5, 10, 20, 50],//分页步进值
search: true,//显示搜索框
//表格的列
columns: [
{
field: 'adId',//域值
title: '广告ID',//标题
visible: true,//false表示不显示
sortable: true,//启用排序
width : '5%',
},
{
field: 'picUrl',//域值
title: '图片',//标题
visible: true,//false表示不显示
sortable: true,//启用排序
width : '15%',
formatter : function (value, row, index) {
return "<img style='width: 50px;height: 50px;' src='"+value+"' alt=''>"
}
},
{
field: 'jumpUrl',//域值
title: '跳转链接',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
editable : true,
cellStyle : function (value, row, index) {
return {
css: {
"max-width": "300px",
"word-wrap": "break-word",
"word-break": "normal"
}
};
}
},
{
field: 'adDesc',//域值
title: '描述',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
editable : true,
},
{
field: 'displayType',//域值
title: '表现形式',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
editable: {
type: 'select',
source: [ //0->无广告,1->静态不可点击,2->静态可点击,3->动态不可点击,4->动态可点击
{value: 0, text: '无广告'},
{value: 1, text: '静态不可点击'},
{value: 2, text: '静态可点击'},
{value: 3, text: '动态不可点击'},
{value: 4, text: '动态可点击'},
]
}
},
{
field: 'displaySeconds',//域值
title: '时间',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '5%',
editable : true,
},
{
field: 'scope',//域值
title: '影响范围',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
editable: {
type: 'select',
source: [ //0->全国
{value: 0, text: '全国'},
]
}
},
{
field: 'userType',//域值
title: '影响群体',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '5%',
editable: {
type: 'select',
source: [ //0->全部
{value: 0, text: '全部'},
]
}
},
{
field: 'status',//域值
title: '状态',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
formatter : function (value, row, index) {
return value==1||value=='1' ? '正在使用' : '没有使用';
}
},
{
field: 'addTime',//域值
title: '时间',//内容
visible: true,//false表示不显示
sortable: true,//启用排序
width : '10%',
}
,{
field: 'operate',
title: '操作',
align: 'center',
events: operateEvents,
width : '25%',
formatter: operateFormatter
}
],
onEditableSave: function (field, row, oldValue, $el) {
$.ajax({
type: "post",
url: "/wadmin/ad/updateAdInfo",
dataType : 'json',
data: row,
success: function (data, status) {
if (status == "success" && data.result == 0) {
toastr.success('更新成功');
if (field == 'jumpUrl') {
$('#table').bootstrapTable("refresh");
}
return true;
} else {
toastr.info(data.message);
$('#table').bootstrapTable("refresh");
}
},
error: function () {
alert("Error");
},
complete: function () {
}
});
}
});
$("#btn_add").click(function () {
$.ajax({
type : "POST",
url : "/wadmin/ad/addAd",
dataType : 'JSON',
success : function (data) {
if (data.result != 0) {
toastr.info("info", data.message);
return ;
}
toastr.success("success", '标签');
$("#table").bootstrapTable('insertRow', {index:0, row:data.data});
}
});
});
function operateFormatter(value, row, index) {
return [
'<a class="using" href="javascript:void(0)" title="Remove">',
'<i class="fa fa-check"></i>',
'</a> ',
'<a class="upload" style="cursor: pointer" href="javascript:void(0)" title="Upload">',
'<label style="cursor: pointer" for="'+row['adId']+'">',
'<i class="fa fa-upload"></i>',
'<input type="file" name="adUpload" style="display: none;" class="adUpload" id="'+row['adId']+'" >',
'</label>',
'</a> ',
'<a class="remove" href="javascript:void(0)" title="Using">',
'<i class="fa fa-times"></i>',
'</a>',
].join('');
}
});