Datatables中文网

print

起始版本号: Buttons 1.0.0

打印表格数据的按钮

注意：这个需要使用Bottons扩展

说明(Description)

这个按钮允许用户打印表格（根据 exportOptions 选项配置的数据）。 构建一个临时的表格显示在新的窗口，然后调用浏览器的打印命令（尽管可以禁用，参考下面 autoPrint选项）。 最终打印窗口取决于用户是否完成打印或者取消了打印。

构建的临时表可能不包含完成的原始表的样式

可以通过 title，message选项来描述文档信息。 或者通过 customize来定制文档（比如添加图片等等）。

选项(Options)

这个按钮有以下选项配置:

名称 默认
text Print
按钮上显示的文字，使用 buttons.buttons.textOption 配置显示的文字内容 或者 buttons.print,关于语言的配置参考 languageOption
className buttons-print
按钮的class名称，详情参见 buttons.buttons.classNameOption
action
显示打印视图
exportOptions {}
选择性的导出数据，包括哪些列，行，排序或者过滤。 详细参考 方法，这里收集所需要的数据
title *
用H1标签显示打印文档标题。如果是 *，那标题则从文档中 titleTag中提取。
message
描述信息，现在在打印视图上，可以包含html
exportOptions {}
选择性的导出数据，包括哪些列，行，排序或者过滤。 详细参考 方法，这里收集所需要的数据
header true
表头将包含在导出的数据中
footer false
表脚将包含在导出的数据中
autoPrint true
当打印视图显示出来的时候调用 window.print()
  • true - window.print()被调用，完成后自动调用 window.close()关闭打印的视图。
  • false - 没有任何动作，打印视图不会自动关闭。
customize null
当打印视图显示之后执行这个函数，这个函数接受一个参数：
  • 1. objectType window - 新窗口的窗口对象。 因此可以使用 window.document.body或者 jQuery / DOM 方法来操作上面的元素。
No return value is expected or acted upon.

示例

Datatables初始化：显示打印按钮 

$('#myTable').DataTable( {
    buttons: [
        'print'
    ]
} );

Datatables初始化：禁止自动显示打印对话框 

$('#myTable').DataTable( {
    buttons: [
        {
            extend: 'print',
            text: 'Print current page',
            autoPrint: false
        }
    ]
} );

Datatables初始化：使用 exportOptions 选项配置打印当前页数据 

$('#myTable').DataTable( {
    buttons: [
        {
            extend: 'print',
            text: 'Print current page',
            exportOptions: {
                modifier: {
                    page: 'current'
                }
            }
        }
    ]
} );

http://datatables.net/reference/button/print

Translation from DataTables.net, with permission