Jquery DataTables buttons扩展-导出excel

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。这是非常有用的，比如在表格上面和表格下面都放有按钮）

1. 使用DataTables（In DataTables）
   作为Datatables构造器的一部分， buttonsOption 选项接受一个数组类型的数据来配置按钮，这通常是按钮的名字，你可以自定义按钮的动作

$('#myTable').DataTable( {
    buttons: [
        'copy', 'excel', 'pdf'
    ]
} );

1. 构造器(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="../../lib/jquery-1.12.4.js">script>

2.datatable相关JS

<script src="../../lib/dataTables/jquery.dataTables.min.js">script>
<script src="../../lib/dataTables/dataTables.bootstrap.min.js">script>
<script src="../../lib/dataTables/dataTables.responsive.min.js">script>

3.需要导出的文件相关JS

<script src="../../lib/dataTables/dataTables.buttons.min.js">script>
<script src="../../lib/dataTables/jszip.min.js">script>
<script src="../../lib/dataTables/buttons.html5.min.js">script>

以上有些必须有些非必须

例子：

代码：

$('#myTable').DataTable( {
    buttons: [
       'extend': 'excelHtml5', //导出文件格式为excel
            'text': '导出',  //按钮标题
            'title': 'XXX-' + start_date + "-" + end_date, //导出的excel标题
            'className': 'btn btn-primary', //按钮的class样式
            'exportOptions':{ //从DataTable中选择要收集的数据。这包括列、行、排序和搜索的选项。请参阅button.exportdata()方法以获得完整的详细信息——该参数所提供的对象将直接传递到该操作中，以收集所需的数据，更多options选项参见：https://datatables.net/reference/api/buttons.exportData()
                'format': { //用于导出将使用的单元格格式化函数的容器对象 format有三个子标签，header，body和foot
                    body: function ( data, row, column, node ) { //body区域的function，可以操作需要导出excel的数据格式
                        if(column === 4 && (data == null || data == "" || data == "0%")){
                            return 0;
                        }
                        else{
                            return data;
                        }
                    }
                }
            }
    ]
} );

更多buttons扩展教程：https://datatables.net/extensions/buttons/examples/html5/simple.html