buttons概念
Buttons提供一套给用户添加自定义按钮的特性,让按钮看起来和表格是一个整体。
Buttons提供了一些基本的按钮,比如打印,导出之类的按钮,也提供了API让用户自己扩展按钮,触发自定义的操作。
当在DataTable中显示数据时,对于终端用户来说,他们有能力从DataTable中获取数据,并将其提取到一个文件中,以便他们在本地使用。这可以用基于HTML5的按钮或Flash按钮来完成。
buttons按钮有四个核心组件(copy,csv,excel,pdf),他们是独立的,你可以自己组合自己需要的插件。可以自动检测浏览器的功能和软件的可用性——如果可能的话,它们会自动使用HTML5按钮,如果没有满足要求,它们会自动回到Flash中,最终不会显示出来。
此插件的官方教程:https://www.datatables.net/extensions/buttons/
此插件的官方关联目录:https://datatables.net/reference/button/
buttons依赖
1.jqeury相关JS
2.datatable相关JS
3.需要导出的文件相关JS
buttons初始化
Buttons初始化有两种不同的方式:
● 在Datatables初始化时使用 buttonsOption 选项
● 通过 new 来初始化
(需要重点注意的是,多个Buttons实例可以被用作同一个Datatables。这是非常有用的,比如在表格上面和表格下面都放有按钮)
使用DataTables(In DataTables)
作为Datatables构造器的一部分, buttonsOption 选项接受一个数组类型的数据来配置按钮,这通常是按钮的名字,你可以自定义按钮的动作
$('#myTable').DataTable( {
buttons: [
'copy', 'excel', 'pdf'
]
} );
构造器(Constructor)
使用 new $.fn.dataTable.Buttons来创建buttons实例。这个方法接受两个参数:
——DT实例对象
——按钮的选项(和 buttonsOption 选项一样 )
var table = $('#myTable').DataTable();
new $.fn.dataTable.Buttons( table, {
buttons: [
'copy', 'excel', 'pdf'
]
} );
buttons位置显示
当你创建了按钮,那么你需要指定按钮的显示位置,便于用户操作,这里有两种方式可以指定按钮的显示位置:
● dom(Option) - Datatables的dom控制参数
● 直接使用API
1.Dom参数(dom parameter)
Datatables有一些表格控制元素可以使用。这些参数可能会有些疑惑,但是简单的说, 每一个字母代表的是Datatables的一个特性。对于Buttons来说,用字符 B代表
$('#myTable').DataTable( {
dom: 'Bfrtip',
buttons: [
'copy', 'excel', 'pdf'
]
} );
dom options 具体信息可查阅:
https://datatables.net/reference/option/dom
2.直接插入(Direct insertion)
使用 buttons().container()API 方法获得jquery对象,然后往里面插入按钮:
buttonsOption 方式
var table = $('#example').DataTable( {
buttons: [
'copy', 'excel', 'pdf'
]
} );
table.buttons().container()
.appendTo( $('.col-sm-6:eq(0)', table.table().container() ) );
new 的方式
var table = $('#myTable').DataTable();
new $.fn.dataTable.Buttons( table, {
buttons: [
'copy', 'excel', 'pdf'
]
} );
table.buttons().container()
.appendTo( $('.col-sm-6:eq(0)', table.table().container() ) );
excel
官方文档:https://datatables.net/reference/button/excel
相关JS依赖:
1.jqeury相关JS
<script src="jquery-1.12.4.js"></script>
1
2.datatable相关JS
<script src="./jquery.dataTables.min.js"></script>
<script src="./dataTables.bootstrap.min.js"></script>
<script src="./dataTables.responsive.min.js"></script>
3.需要导出的文件相关JS
<script src="./dataTables.buttons.min.js"></script>
<script src="./jszip.min.js"></script>
<script src="./buttons.html5.min.js"></script>
以上有些必须有些非必须
例子:
代码:
$('#myTable').DataTable( {
buttons: [
'extend': 'excelHtml5', //导出文件格式为excel
'text': '导出excel', //按钮标题
'title': 'pre' + _date, //导出的excel标题
'className': 'btn btn-primary', //按钮的class样式
'exportOptions':{ //选项参见:https://datatables.net/reference/api/buttons.exportData()
'format': { // format有三个子标签,header,body和foot
body: function ( data, row, column, node ) { //操作需要导出excel的数据格式
if(column === 2){
return 0;
}
else{
return data;
}
}
}
}
]
} );