目录

1.默认常量信息(表)

1.1. 无法转换为自定义方法

1.2. 可转换为自定义方法

2.字段属性

3.方法相关api

4.事件相关api

5.初始化配置

---

Bootstrap table 是一款基于 Bootstrap 的 jQuery 表格插件

1.默认常量信息(表)

1.1. 无法转换为自定义方法

属性	默认值	描述
height	undefined	表格的高度
classes	table table-bordered table-hover	表格的类名称
buttons	{}	按钮,bootstraptable加载的按钮集,可自定义
theadClasses	表头样式	''
undefinedText	'-'	当数据为 undefined 时显示的字符
locale	undefined	语言设置
virtualScroll	false	是否开启虚拟滚动
virtualScrollItemHeight	undefined	虚拟滚动条项目高度
sortable	true	是否启用排序
sortClass	undefined	被排序的td标签的class名
silentSort	true	是否开启自动记住排序项,设置为 false 将在点击分页按钮时，自动记住排序项。仅在 sidePagination设置为 server时生效
sortEmptyLast	false	排序最后一个空
sortName	undefined	定义排序列信息
sortOrder	undefined	定义排序方式 asc 或者 desc
sortReset	false	是否开启重置排序
sortStable	false	设置为 true 将获得稳定的排序
sortResetPage	false	排序是否重置页面
rememberOrder	false	是否记住顺序
serverSort	true	服务器排序
customSort	undefined	自定义排序
columns	[[]]	列配置项,一般为表格显示的字段信息
data	[]	加载json格式的数据
url	undefined	服务器数据的加载地址
method	get	请求方式,一般列表请求都是get请求,特殊情况特殊处理
cache	true	是否使用ajax缓存,true为禁用ajax缓存
contentType	application/json	发送到服务器的数据编码类型
dataType	json	服务器返回的数据类型
ajax	undefined	自定义 AJAX 方法,须实现 jQuery AJAX API
ajaxOptions	{}	提交ajax请求时的附加参数
queryParamsType	limit	设置为 ‘limit’ 则会发送符合 RESTFul 格式的参数
totalField	total	分页总条数对应的字段,可根据封装的json自定义调整
totalNotFilteredField	totalNotFiltered	json响应中的字段,用于服务器端定义分页计数
dataField	rows	分页数据所对应的字段,可根据封装的json自定义调整
footerField	footer	页脚所对应的字段
pagination	false	是否显示分页 true显示 false隐藏
paginationParts	['pageInfo', 'pageSize', 'pageList']	定义了分页信息哪些部分可见 pageInfo:显示总行数且此页行范围pageSize:每页多少行下拉框pageList:分页按钮
showExtendedPagination	false	是否显示分页的扩展版本
paginationLoop	true	是否启用分页条无限循环的功能
sidePagination	client	分页方式 server服务端分页client客户端分页
totalRows	0	总行数该属性主要由分页服务器传递
totalNotFiltered	0	未筛选总数
pageNumber	1	初始化加载第一页，默认第一页
pageSize	10	每页的记录行数
pageList	[10, 25, 50, 100]	可供选择的每页的行数
paginationHAlign	right	分页条水平方向的位置 left最左 right最右
paginationVAlign	bottom	分页条垂直方向的位置 bottom 底部 top顶部 both:顶/底都存在
paginationDetailHAlign	left	分页明细显示位置,left最左 right最右
paginationPreText	'‹'	上一页的按钮符号
paginationNextText	'›'	下一页的按钮符号
paginationSuccessivelySize	5	左边的最大连续页数 < 1.2.3.4.5 ... n > 建议:5
paginationPagesBySide	1	右边的最大连续页数 < 1.2.3.4.5 ... 80 >
paginationUseIntermediate	false	计算并显示中间页面以便快速访问
search	false	是否显示搜索框功能(客户端搜索)
searchable	false	是否可检索的(一般应用于字段)
searchHighlight	false	是否对搜索内容高亮展示
searchOnEnterKey	false	是否按下EnterKey才进行搜索
strictSearch	false	是否启用启用严格搜索
regexSearch	false	是否启用启用正则搜索
searchSelector	false	自定义搜索框选择器
visibleSearch	false	为仅在可见列/数据中搜索
showButtonIcons	true	是否显示按钮图标
showButtonText	false	是否在按钮上显示文本
showSearchButton	false	是否在搜索输入后面显示搜索按钮
showSearchClearButton	false	是否在搜索输入后面显示清除按钮
trimOnSearch	true	是否自动忽略空格
searchAlign	right	指定搜索输入框的方向 left最左 right最右
searchTimeOut	500	搜索超时时间
searchText	''	设置搜索文本框的默认搜索值
customSearch	undefined	自定义搜索
showHeader	true	是否显示表头 true显示 false隐藏
showFooter	false	是否显示页脚 true显示 false隐藏
searchAccentNeutralise	false	是否开启搜索重音中和,若要使用重音消除功能，请设置为true
showColumns	false	是否显示所有的列 true显示 false隐藏
showColumnsToggleAll	false	是否在列选项/下拉列表中显示“全部切换”复选框
showColumnsSearch	false	是否显示对列过滤器的搜索
minimumCountColumns	1	最少允许的列数
showPaginationSwitch	false	是否显示分页组件的切换按钮 true显示 false隐藏
showRefresh	false	是否显示刷新按钮 true显示 false隐藏
showToggle	false	是否显示详细视图和列表视图的切换按钮 true显示 false隐藏
showFullscreen	false	是否显示全屏按钮 true显示 false隐藏
smartDisplay	true	是否智能显示分页或卡片视图 true是 false 否
escape	false	是否开启html转义
escapeTitle	true	是否转义标题
idField	undefined	表明哪个是字段是标识字段
selectItemName	‘btSelectItem’	设置radio 或者 checkbox的字段名称
clickToSelect	false	是否启用点击选中行 true 启用 false禁用
singleSelect	false	是否单选checkbox
checkboxHeader	true	表头是否展示checkbox
maintainMetaData	false	是否维护元数据
multipleSelectRow	false	是否启用多选行
uniqueId	undefined	唯一的标识符
cardView	false	是否启用卡片视图
detailView	false	是否启用明细视图
detailViewIcon	true	是否显示详细视图图标
detailViewByClick	false	是否允许单击单元格时切换细节视图
detailViewAlign	left	详细信息视图图标对齐方式
toolbar	undefined	指定工具栏
toolbarAlign	left	指示如何对齐自定义工具栏
buttonsToolbar	undefined	一个jQuery选择器，指示按钮工具栏
buttonsAlign	right	指示如何对齐工具栏按钮
buttonsOrder	['paginationSwitch', 'refresh', 'toggle', 'fullscreen', 'columns']	工具栏按钮重新排序
buttonsPrefix	CONSTANTS.classes.buttonsPrefix	按钮前缀 'btn'
buttonsClass	CONSTANTS.classes.buttons	按钮样式
iconsPrefix	undefined	图标前缀
icons	{}	图标,此处可以自定义
iconSize	undefined	图标大小：undefined默认的按钮尺寸 xs超小按钮sm小按钮lg大按钮
loadingFontSize	'auto'	自定义加载文本的字体大小
striped	true	是否显示行间隔色

1.2. 可转换为自定义方法

属性	默认值	描述
headerStyle(column)	return {}	标头样式格式化程序函数
rowStyle (row, index)	return {}	设置行样式的函数支持类或css
rowAttributes (row, index)	return {}	row属性formatter函数，支持所有自定义属性
queryParams (params)	return params	要传递参数
responseHandler (res)	return res	请求获取数据后处理回调函数
footerStyle (column)	return {}	页脚样式设置。
ignoreClickToSelectOn ({ tagName })	return ['A', 'BUTTON'].includes(tagName)	忽略点击选中
detailFormatter (index, row)	return ''	格式化细节视图
detailFilter (index, row)	return true	是否对返回行进行拓展
loadingTemplate (loadingMessage)	return ‘...’	加载模版

2.字段属性

属性	默认值	描述
field	undefined	设置data-field的值,字段返回标识
title	undefined	设置data-field的值,字段显示内容
titleTooltip	undefined	列标题工具提示文本
class	undefined	定义列的类名
width	undefined	列的宽度
widthUnit	'px'	列的宽度单元
rowspan	undefined	指定单元格应占用的行数
colspan	undefined	指定单元格应占用的列数
align	undefined	数据对齐方式
halign	undefined	表头对齐方式
falign	undefined	表格页脚对齐方式
valign	undefined	单元格数据对齐方式
cellStyle	undefined	单元格样式格式化函数
radio	false	单选框(一般都单独提出表格)
checkbox	false	复选框(一般都单独提出表格)
checkboxEnabled	true	设置false以禁用复选框/单选框
clickToSelect	true	是否点击选中
showSelectTitle	false	显示选择框标题,设置为true以使用'radio'或'singleSelect''复选框'选项显示列的标题
sortable	false	列是否允许排序
sortName	undefined	排序字段名
order	'asc'	排序方式
sorter	undefined	用于进行本地排序的自定义字段排序函数
visible	true	列是否可见
switchable	true	是否可切换列
switchableLabel	undefined	可交换的标识
cardVisible	true	是否隐藏card 视图状态中的列项
searchable	true	是否可搜索此列的数据
formatter	undefined	单元格格式函数
footerFormatter	undefined	页脚格式化.页脚单元格中显示的文本
detailFormatter	undefined	明细格式化.
searchFormatter	true	搜索格式化
searchHighlightFormatter	false	搜索高亮格式化
escape	undefined	是否转义字符串(HTMl)
events	undefined	监听事件(function)

3.方法相关api

方法名	方法用途
getOptions	获取表格的参数
refreshOptions	刷新表格参数
getData	获取当前表格中加载的数据，参数useCurrentPage为true 将返回当前页内的数据
getSelections	获取当前被选中的行
load	将新数据加载到表格中
append	将新数据加载到表格末尾中
prepend	将新数据插入到表格头部
remove	从表格中移除列名为指定值的数据
removeAll	移除表格中的所有数据
insertRow	插入多个新行到指定位置 params > index:要插入到行的索引 row: 要插入的行数据
updateRow	更新指定行
getRowByUniqueId	根据唯一ID获取行数据
updateByUniqueId	根据唯一ID更新行数据每一行 params > id: 唯一ID row: 新的行数据
removeByUniqueId	根据唯一ID移除行数据
updateCell	更新一个单元格数据
updateCellByUniqueId	更新id指定的一个单元格
showRow	显示指定行
hideRow	隐藏指定行
getHiddenRows	获取所有隐藏的行数据
showColumn	显示指定列
hideColumn	隐藏指定列
getVisibleColumns	获取可见的列
getHiddenColumns	获取隐藏的列
showAllColumns	展示所有列
hideAllColumns	隐藏所有列
mergeCells	合并多个单元格
checkAll	选中当前页的所有行
uncheckAll	取消选中当前页的所有行
checkInvert	对当前页内行数据进行反选
check	选中某一行，索引从0开始
uncheck	取消选中某一行，索引从0开始
checkBy	根据列名选则行数据
uncheckBy	根据列名取消选中行数据
refresh	重新加载远程数据
destroy	销毁表格
resetView	重置表格视图
showLoading	显示数据加载状态提示
hideLoading	隐藏数据加载状态提示
togglePagination	切换分页参数
toggleFullscreen	切换全屏展示
toggleView	切换 card/table 视图
resetSearch	设置搜索内容
filterBy	在client模式下，对表格数据进行过滤
sortBy	设置排序方式
scrollTo	使滚动条滚动到指定位置，单位像素，'bottom' 滚动条滚动到底
getScrollPosition	获取当前滚动条的位置，单位像素
selectPage	跳转到指定页
prevPage	上一页
nextPage	下一页
toggleDetailView	切换细节视图
expandRow	展开指定索引的行的详细视图
collapseRow	收起指定索引的行的详细视图
expandRowByUniqueId	展开指定UniqueId的行的详细视图
collapseRowByUniqueId	收起指定UniqueId的行的详细视图
expandAllRows	展开所有行的详细视图
collapseAllRows	收起所有行的详细视图
updateColumnTitle	更新列标题
updateFormatText	更新格式文本

4.事件相关api

方法名	监听内容	描述
onAll	all.bs.table	任何事件触发都会同时触发该事件
onClickRow	click-row.bs.table	当点击某一行时触发
onDblClickRow	dbl-click-row.bs.table	当双击击某一行时触发
onClickCell	click-cell.bs.table	当点击某一个单元格时触发
onDblClickCell	dbl-click-cell.bs.table	当双击某一个单元格时触发
onSort	sort.bs.table	当点击对某一字段列进行排序时触发
onCheck	check.bs.table	当选中某一行时触发
onUncheck	uncheck.bs.table	当取消选中某一行时触发
onCheckAll	check-all.bs.table	当点击全选时出发
onUncheckAll	uncheck-all.bs.table	当取消全选时出发
onCheckSome	check-some.bs.table	当选中某些行时触发
onUncheckSome	uncheck-some.bs.table	当取消选中某些行时触发
onLoadSuccess	load-success.bs.table	当加载成功时触发
onLoadError	load-error.bs.table	当加载失败时触发
onColumnSwitch	column-switch.bs.table	当切换某列的显示状态时触发
onColumnSwitchAll	column-switch-all.bs.table	当切换全部列的显示状态时触发
onPageChange	page-change.bs.table	当切换每页条数时触发
onSearch	search.bs.table	当对表格内容进行搜索时触发
onToggle	toggle.bs.table	当切换表格的显示视图时触发
onPreBody	pre-body.bs.table	在对表格体进行渲染前触发
onPostBody	post-body.bs.table	在表格体渲染完成后触发
onPostHeader	post-header.bs.table	在表格列头渲染完成后触发
onPostFooter	post-footer.bs.table	在表格页脚渲染完成后触发
onExpandRow	expand-row.bs.table	当点击详情按钮展开详情视图时触发
onCollapseRow	collapse-row.bs.table	当点击关闭详情按钮收起详情视图时触发
onRefreshOptions	refresh-options.bs.table	当刷新表格选项时，在销毁当前表格并重新初始化新表格之前触发
onResetView	reset-view.bs.table	当重置表格视图时触发
onRefresh	refresh.bs.table	当点击刷新按钮对表格进行刷新时触发
onScrollBody	scroll-body.bs.table	当对表格体进行滚动时触发
onTogglePagination	toggle-pagination.bs.table	当点击切换分页时触发
onVirtualScroll	virtual-scroll.bs.table	当发生虚拟滚动时触发

5.初始化配置

初始化一下常用的配置,可直接移植到项目中使用,一些默认自带的可以省去,罗列出项目中常用的属性,如属性不满足可参考常量信息表自行添加

var table = $("#bootstrap-table-list");
​
// 初始化表格
table.bootstrapTable({
   url: url,                           //请求后台的URL（*）用于从远程站点请求数据的URL
   method: 'get',                      //请求方式（*）
   toolbar: '#toolbar',                //工具栏
   buttonsClass:'secondary',           //定义工具按钮的Bootstrap类（在'btn-'之后添加）
   striped: true,                      //是否显示行间隔色
   cache: false,                       //是否使用缓存，默认为true
   pagination: true,                   //是否显示分页
   sortable: true,                     //是否启用排序
   sortName:'',                        //定义要排序的列
   sortOrder: "asc",                   //定义列排序顺序，只能是'asc'或'desc'。
   sortStable: false,                  //是否启用稳定排序
   queryParams: oTableInit.queryParams,//传递参数（*）
   sidePagination: "server",           //分页方式：client客户端分页（默认），server服务端分页（*）
   pageNumber:1,                       //初始化加载第一页，默认第一页
   pageSize: 10,                       //每页的记录行数（*）
   pageList: [10, 25, 50, 100],        //可供选择的每页的行数（*）
   search: true,                       //是否显示表格搜索input
   showColumns: false,                 //是否显示所有的列
   showRefresh: true,                  //是否显示刷新按钮 默认false
   minimumCountColumns: 1,             //最少允许的列数 要从列下拉列表中隐藏的最小列数
   clickToSelect: true,                //是否启用点击选中行
   height: 500,                        //行高 
   uniqueId: "id",                     //表明每一行的唯一标识字段，一般为主键列
   showToggle:true,                    //是否显示详细视图和列表视图的切换按钮
   cardView: false,                    //是否显示详细视图
   detailView: false,                  //设置为true以显示detail 视图表（细节视图）
   locale:'zh-CN',                     //语言设置
   height:800,                         //固定表格的高度     
   data:[],                            //要加载的数据 [] or {}
   contentType:'application/json',     //请求远程数据的contentType(现在大部分都是json请求) 
   dataType:'json',                    //服务器返回的数据类型    
   totalField:'total',                 //分页总条数对应的字段,可根据封装的json自定义调整
   dataField:'rows',                   //分页数据所对应的字段,可根据封装的json自定义调整  
   showHeader:true,                    //是否显示表头    
   showFooter:false,                   //是否显示页脚
   showPaginationSwitch:false,         //是否显示分页组件的切换按钮    
   showFullscreen:false,               //是否显示全屏按钮      
   clickToSelect:false,                //是否启用点击选中行
   singleSelect:false,                 //是否允许复选框仅选择一行
   loadingFontSize:'auto',             //加载文本的字体大小
   multipleSelectRow:false,            //是否启用多选行
   icons:icon,                         //自定义icon图标
   iconSize:'undefined',               //icon图表的尺寸大
   iconsPrefix:'fa',                   //图标前缀   
   queryParamsType:'limit',            //设置'limit'以使用RESTFul类型发送查询参数。        
   queryParams: function(params) {     //请求远程数据时，
      var reqParams = {
           // 传递参数查询参数
           pageSize:       params.limit,
           pageNum:        params.offset / params.limit + 1,
           searchValue:    params.search,
          "自定义":"自定义",
      };
       return reqParams; 　　　　
  },   
   responseHandler:function(res) {     //请求获取数据后处理回调函数  
       return res;
​
  },   
   onLoadSuccess: function (data){//表选项也可以时使用事件，列选项的事件则是在events
       //数据加载成功时触发
       console.log(data);
   
  },
   columns: [
      {checkbox: false},
      {radio: false},
      {
           radio: false,//此列转成radio上面单独领出来是应为有字段显示就不需要它呀
           checkbox: false,//此列转成checkbox 单独拎出来同上
           field: '对应服务器返回的字段信息', 
           title: 'table上显示的信息'
           align:'center',//指定如何对齐列数据。可以使用'left'，'right'，'center'
           formatter:function()//自定义格式化信息,一般是对状态等进行标识映射
      },
      {
           field:'opreation',
           tittle:'操作',
           aligin:'center',
           formatter:function(value,row,index,field){
               return[ 
"要添加的按钮"
              ];
          },
      }
  ]
});
​
​
/**
* 重写bootstrap-table 图标
* @type {{toggleOff: string, clearSearch: string, detailOpen: string, search: string, fullscreen: string, columns: string, detailClose: string, refresh: string, paginationSwitchDown: string, paginationSwitchUp: string, toggleOn: string}}
*/
window.icons={
   paginationSwitchDown: 'fa-caret-square-down',
   paginationSwitchUp: 'fa-caret-square-up',
   refresh: 'fa-sync',
   toggleOff: 'fa-toggle-off',
   toggleOn: 'fa-toggle-on',
   columns: 'fa-th-list',
   detailOpen: 'fa-plus',
   detailClose: 'fa-minus',
   fullscreen: 'fa-arrows-alt',
   search: 'fa-search',
   clearSearch: 'fa-trash',
   print:'fa-trash',
   export:'fa-trash',
}
​